@kmlckj/aios-agent-server-sdk 0.0.0-stage → 0.0.2

package/dist/shared/local-memory.d.ts

@@ -0,0 +1,165 @@
+export declare const MEMORY_GROUPS: readonly ["工作背景", "个人背景", "当前关注", "近期动态"];
+export type MemoryGroup = typeof MEMORY_GROUPS[number];
+export type MemoryKind = 'instruction' | 'fact' | 'preference' | 'decision' | 'task';
+/** Long-term memory belongs to one account, independent of enterprise or personal mode. */
+export interface MemoryScope {
+    environment: 'dev' | 'prod';
+    userId: string; /** Host-authorized namespace; absent for existing desktop/CLI account memory. */
+    namespace?: string;
+}
+export interface MemorySource {
+    kind: 'user_edit' | 'user_import' | 'conversation';
+    taskId?: string;
+    messageId?: string;
+    generation?: string;
+    role?: string;
+    occurredAt: string | null;
+}
+export interface MemoryResource {
+    id: string;
+    kind: 'file' | 'skill';
+    name: string;
+    path: string;
+    version: string;
+}
+export interface MemoryApplicability {
+    platforms?: Array<'win32' | 'darwin' | 'linux'>;
+    resources?: MemoryResource[];
+}
+export interface MemoryLifecycle {
+    state: 'ongoing' | 'completed';
+    expiresAt?: string;
+}
+export interface MemoryRecallContext {
+    platform: string;
+    projectId?: string;
+    permissionVersion: string;
+}
+export interface MemoryRecord {
+    /** subject names the entity or topic; content describes it. Present both to users and consumers. */
+    id: string;
+    revision: number;
+    kind: MemoryKind;
+    group: MemoryGroup;
+    subject: string;
+    content: string;
+    originalInstruction?: string;
+    occurredAt: string | null;
+    status: 'active' | 'candidate' | 'conflicted' | 'superseded' | 'invalidated';
+    sources: MemorySource[];
+    updatedAt: string;
+    conflictsWith?: string[];
+    createdAt?: string;
+    manualUpdatedAt?: string;
+    contentDigest?: string;
+    applicability?: MemoryApplicability;
+    lifecycle?: MemoryLifecycle;
+    invalidationReason?: 'source_changed' | 'resource_changed' | 'expired' | 'unsupported_evidence' | 'unresolved_conflict';
+    previous?: {
+        revision: number;
+        content: string;
+        updatedAt: string;
+    };
+}
+export interface MemoryState {
+    organizationVersion?: 2;
+    version: 1;
+    epoch: string;
+    revision: number;
+    enabled: boolean;
+    resetAt: string;
+    updatedAt?: string;
+    operation?: MemoryOperation;
+    cursors: Record<string, string>;
+    revoked?: string[];
+    deletedSubjects?: Record<string, string>;
+    collectionAfter?: string;
+    cleanupEpochs?: string[];
+    completedOperations?: string[];
+    quarantined?: string[];
+}
+export interface MemoryOperation {
+    id: string;
+    status: 'running' | 'completed' | 'failed' | 'cancelled';
+    mode?: 'edit' | 'import' | 'extract';
+    error?: string;
+    clarification?: string;
+}
+export interface MemoryView {
+    scope: MemoryScope;
+    enabled: boolean;
+    revision: number;
+    updatedAt?: string;
+    groups: Array<{
+        title: MemoryGroup;
+        items: MemoryRecord[];
+    }>;
+    total: number;
+    operation?: MemoryOperation;
+    storageNotice?: string;
+    page?: number;
+    hasMore?: boolean;
+}
+export interface MemoryChange {
+    action: 'add' | 'merge' | 'replace' | 'remove' | 'no_change';
+    id?: string;
+    revision?: number;
+    kind?: MemoryKind;
+    group?: MemoryGroup;
+    subject?: string;
+    content?: string;
+    originalInstruction?: string;
+    occurredAt?: string | null;
+    sourceIds?: string[];
+    applicability?: Omit<MemoryApplicability, 'resources'>;
+    resourceIds?: string[];
+    lifecycle?: MemoryLifecycle;
+}
+export interface MemoryProposal {
+    changes: MemoryChange[];
+    clarification?: string;
+}
+export interface MemorySearchHit {
+    id: string;
+    subject: string;
+    content: string;
+    kind: MemoryKind;
+    group: MemoryGroup;
+    sources: MemorySource[];
+    lifecycle?: MemoryLifecycle;
+    occurredAt?: string | null;
+}
+export interface HistoryHit {
+    id: string;
+    taskId: string;
+    recordId: string;
+    role: string;
+    occurredAt: string;
+    content: string;
+    generation: string;
+    truncated: boolean;
+}
+export interface MemoryContextRequest {
+    page?: number; /** SDK management calls select an explicitly authorized session. */
+    sessionId?: string;
+}
+export interface MemoryEditRequest extends MemoryContextRequest {
+    text: string;
+    mode: 'edit' | 'import';
+    operationId: string;
+}
+export interface LocalMemoryApi {
+    get(request?: MemoryContextRequest): Promise<MemoryView>;
+    setEnabled(request: MemoryContextRequest & {
+        enabled: boolean;
+    }): Promise<MemoryView>;
+    edit(request: MemoryEditRequest): Promise<MemoryView>;
+    reset(request: MemoryContextRequest): Promise<MemoryView>;
+}
+export declare function sameMemoryIdentity(a: MemoryScope, b: MemoryScope): boolean;
+/** A bounded deterministic lexical vocabulary, including Chinese words without a vector service. */
+export declare function memoryTerms(text: string): string[];
+export declare function memorySearchExpression(text: string): string;
+export declare function memoryInput(value: unknown, limit?: number): string;
+/** Credential-bearing lines never enter the persistent memory pipeline. */
+export declare function redactMemorySecrets(text: string): string;

package/dist/shared/local-plugin-api.d.ts

@@ -0,0 +1,26 @@
+import type { LocalTaskPluginReference } from './local-task-api.js';
+import type { PluginMarketDetail } from './plugin-market-api.js';
+export type LocalPluginSource = 'PLATFORM' | 'ENTERPRISE';
+export interface LocalPluginInstallation {
+    plugin: PluginMarketDetail;
+    runtime: LocalTaskPluginReference;
+    source: LocalPluginSource;
+    enabled: boolean;
+    installedAt: string;
+    updatedAt: string;
+}
+export interface InstallLocalPluginRequest {
+    plugin: PluginMarketDetail;
+    source: LocalPluginSource;
+}
+export interface SetLocalPluginEnabledRequest {
+    pluginId: string;
+    enabled: boolean;
+}
+export interface LocalPluginApi {
+    list: () => Promise<LocalPluginInstallation[]>;
+    refresh: () => Promise<LocalPluginInstallation[]>;
+    install: (request: InstallLocalPluginRequest) => Promise<LocalPluginInstallation>;
+    setEnabled: (request: SetLocalPluginEnabledRequest) => Promise<LocalPluginInstallation>;
+    remove: (pluginId: string) => Promise<void>;
+}

package/dist/shared/local-runtime-api.d.ts

@@ -0,0 +1,32 @@
+export type LocalRuntimeStatus = 'unavailable' | 'stopped' | 'starting' | 'ready' | 'stopping' | 'failed';
+export interface LocalRuntimeExecutionLease {
+    taskId: string;
+    runId: string;
+    acquiredAt: string;
+}
+export interface LocalRuntimeTaskState {
+    resourceConfiguration?: import('./task-resource-manifest.js').TaskResourceManifest['configuration'];
+    status: LocalRuntimeStatus;
+    taskId: string;
+    startedAt?: string;
+    stoppedAt?: string;
+    lastError?: string;
+    executionLease?: LocalRuntimeExecutionLease;
+}
+export interface LocalRuntimeState {
+    status: LocalRuntimeStatus;
+    taskId?: string;
+    startedAt?: string;
+    stoppedAt?: string;
+    lastError?: string;
+    executionLease?: LocalRuntimeExecutionLease;
+    taskStates?: LocalRuntimeTaskState[];
+    executionLeases?: LocalRuntimeExecutionLease[];
+}
+export interface LocalRuntimeApi {
+    getState: () => Promise<LocalRuntimeState>;
+    start: (taskId: string) => Promise<LocalRuntimeState>;
+    stop: (taskId: string) => Promise<LocalRuntimeState>;
+    restart: (taskId: string) => Promise<LocalRuntimeState>;
+    onStateChanged: (listener: (state: LocalRuntimeState) => void) => () => void;
+}

package/dist/shared/local-skill-api.d.ts

@@ -0,0 +1,42 @@
+import type { LocalTaskSkillReference } from './local-task-api.js';
+import type { PersonalSkillUploadResult } from './skill-upload.js';
+export type LocalSkillImportKind = 'FILE' | 'DIRECTORY';
+export interface LocalSkillDefinition {
+    /** Opaque installation/profile identity; never a portable same-name reference. */
+    executionScope?: string;
+    /** 新版本地技能的稳定身份，等于安装目录名称。 */
+    folderName: string;
+    /**
+     * UI 和既有项目配置使用的本地引用。新版等于 folderName；旧版保持原有
+     * local:<digest> 值，读取旧数据时不会改写磁盘内容。
+     */
+    reference: string;
+    legacySkillId?: string;
+    name: string;
+    description: string;
+    version?: string;
+    packagePath: string;
+    skillPath: string;
+    installedAt: string;
+    updatedAt: string;
+}
+export interface ImportLocalSkillsRequest {
+    kind: LocalSkillImportKind;
+}
+export interface ImportLocalSkillsResult {
+    canceled: boolean;
+    skills: LocalSkillDefinition[];
+}
+export interface LocalSkillContent {
+    skill: LocalSkillDefinition;
+    content: string;
+}
+export interface LocalSkillApi {
+    list: () => Promise<LocalSkillDefinition[]>;
+    getContent: (reference: string) => Promise<LocalSkillContent>;
+    openDirectory: (reference: string) => Promise<void>;
+    importFromDialog: (request: ImportLocalSkillsRequest) => Promise<ImportLocalSkillsResult>;
+    remove: (reference: string) => Promise<void>;
+    uploadToPersonal: (reference: string) => Promise<PersonalSkillUploadResult>;
+    prepareForLocalTask: (reference: string) => Promise<LocalTaskSkillReference>;
+}