Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
import type { PiPackageCommandDiagnostic } from '@cindy/maker-core';
import type { PiExtensionUiApi } from '@cindy/maker-core/pi-extension-ui';
export type { PiExtensionUiApi } from '@cindy/maker-core/pi-extension-ui';
export type PiPackageResourceKind = 'extension' | 'skill' | 'prompt' | 'theme';
export type PiPackageCompatibility = 'supported' | 'partial' | 'unsupported' | 'unknown';
export type PiPackageCompatibilityIssue =
| 'interactive-dialogs'
| 'notifications'
| 'status-display'
| 'widgets'
| 'terminal-title'
| 'editor-integration'
| 'tui-layout'
| 'custom-ui'
| 'theme-control'
| 'terminal-input'
| 'tui-rendering'
| 'cli-flags'
| 'analysis-incomplete';
export interface PiPackageResourceView {
kind: PiPackageResourceKind;
name: string;
compatibility: PiPackageCompatibility;
compatibilityIssues?: PiPackageCompatibilityIssue[];
detectedApis?: PiExtensionUiApi[];
}
export interface PiPackageRuntimeRequirement {
packageName: string;
range: string;
currentVersion?: string;
compatible: boolean | null;
reason?: 'legacy-runtime-package';
}
export interface PiPackageView {
source: string;
/** Main-owned opaque target when the displayed source is deliberately redacted. */
mutationTarget?: string;
name: string;
version?: string;
enabled: boolean;
/** False when Cindy must not send this persisted source back to Pi. */
manageable?: false;
/** False when this package has no verified Extension, Skill, or Prompt to enable. */
canToggle?: false;
/** Extension code stays disabled until the user explicitly accepts full Pi-process access. */
requiresExtensionApproval?: boolean;
resources: PiPackageResourceView[];
runtimeRequirements?: PiPackageRuntimeRequirement[];
warning?:
| 'no-resources'
| 'inspection-failed'
| 'inspection-limit'
| 'unsupported-filter'
| 'unsafe-source';
}
export interface PiPackageListResult {
available: boolean;
packages: PiPackageView[];
}
export type PiPackageMutationAction = 'install' | 'remove' | 'update' | 'set-enabled';
/** Relative filesystem sources need a task working directory; Settings has none. */
export function isRelativeLocalPiPackageSource(value: string): boolean {
const source = value.trim();
if (!source) return false;
const fileSource = /^file:(.*)$/i.exec(source);
if (fileSource) {
const filePath = fileSource[1];
if (!filePath || filePath.startsWith('/') || filePath.startsWith('\\\\')) return false;
if (/^[a-z]:[/\\]/i.test(filePath)) return false;
return true;
}
if (source.startsWith('/') || source.startsWith('\\\\')) return false;
if (/^[a-z]:/i.test(source)) return !/^[a-z]:[/\\]/i.test(source);
if (/^[a-z][a-z0-9+.-]*:/i.test(source)) return false;
if (/^[^/\\\s]+@[^/\\\s]+:.+/.test(source)) return false;
if (/^@[^/\\\s]+[/\\][^/\\\s]+(?:@[^/\\\s]+)?$/.test(source)) return false;
return source === '.'
|| source === '..'
|| source.startsWith('./')
|| source.startsWith('../')
|| source.startsWith('.\\')
|| source.startsWith('..\\')
|| source.includes('/')
|| source.includes('\\');
}
export interface PiPackageMutationRequest {
action: PiPackageMutationAction;
source: string;
/** Main-owned opaque identity for a deliberately redacted persisted source. */
mutationTarget?: string;
enabled?: boolean;
}
export interface PiPackageMutationResult extends PiPackageListResult {
changed: boolean;
/** Set only after the native install/update/remove command exits with zero. */
nativeCommandSucceeded?: true;
/** Advisory Cindy assistance failures do not change native command success. */
diagnostics?: PiPackageCommandDiagnostic[];
affectedPackage?: PiPackageView;
/** The mutation succeeded, but packages is not an authoritative full roster. */
projectionUnavailable?: true;
/** The package change committed, but at least one local Pi runtime may remain alive. */
runtimeConvergence?: 'partial';
}
export function hasPiPackageCompatibilityWarning(pkg: PiPackageView): boolean {
return pkg.warning !== undefined
|| pkg.resources.some((resource) => resource.compatibility !== 'supported')
|| pkg.runtimeRequirements?.some((requirement) => requirement.compatible !== true) === true;
}
export interface PiPackageSlashCommand {
kind: 'agent-builtin';
name: string;
description: string;
}
export type PiPackageCommandRuntimeStatus =
| 'pending'
| 'loaded'
| 'failed'
| 'unknown';
export function listPiRuntimePaletteCommands(
commands: ReadonlyArray<{ name: string; description?: string | null }>,
authorizedNames: readonly string[] | undefined,
): Array<{ name: string; description: string }> {
const names = new Set(authorizedNames ?? []);
return commands.flatMap((command) =>
names.has(command.name) && !command.name.startsWith('skill:')
? [{
name: command.name,
description: command.description ?? `Pi extension command: ${command.name}`,
}]
: [],
);
}
/** Runtime-confirmed Pi package commands belong only to the Pi command palette. */
export function mergePiPackageCommands(
agentKind: 'claude-code' | 'codex' | 'pi',
builtins: PiPackageSlashCommand[],
packageCommands: Array<{ name: string; description: string }>,
): PiPackageSlashCommand[] {
if (agentKind !== 'pi') return builtins;
const names = new Set(builtins.map((command) => command.name.toLowerCase()));
return [
...builtins,
...packageCommands.flatMap((command) => {
const key = command.name.toLowerCase();
if (!command.name || names.has(key)) return [];
names.add(key);
return [{ kind: 'agent-builtin' as const, ...command }];
}),
];
}
export function shouldListPiPackageCommands(
requestedAgentKind: 'claude-code' | 'codex' | 'pi',
sessionIdProvided: boolean,
session: {
agentKind: 'claude-code' | 'codex' | 'pi';
reviewMode?: true;
remoteHostId?: string;
} | null,
allowUnboundLocalPreview = true,
): boolean {
if (requestedAgentKind !== 'pi') return false;
// New local Pi task: there is no session yet, so the Cindy-owned local
// package roster is the correct preview.
if (!sessionIdProvided) return allowUnboundLocalPreview;
// Existing tasks must be proven local, ordinary Pi tasks by host-owned
// metadata. Missing/mismatched metadata fails closed.
return session?.agentKind === 'pi' && session.reviewMode !== true && !session.remoteHostId;
}