@kmlckj/aios-agent-server-sdk 0.0.1 → 0.0.5

package/dist/sdk/src/index.d.ts

@@ -66,6 +66,12 @@ export declare class AiosClient {
     };
     readonly skills: {
         list: () => Promise<import("./types.js").LocalSkillDefinition[]>;
+        /** Installs an additive immutable package version; does not change task selections. */
+        importVersion: (request: {
+            packagePath: string;
+            folderName: string;
+            packageSha256: string;
+        }) => Promise<import("./types.js").LocalSkillDefinition>;
         importPaths: (paths: string[]) => Promise<import("./types.js").LocalSkillDefinition[]>;
         remove: (reference: string) => Promise<void>;
     };
@@ -98,6 +104,8 @@ export declare class AiosClient {
     defineAgent(definition: AgentDefinition): Promise<Agent>;
     private registerAgent;
     openSession(id: string): Promise<Session>;
+    /** Reopen an immutable, already defined agent version without replacing its tool registrations. */
+    openAgent(id: string, version: string): Promise<Agent>;
     listSessions(query?: {
         scope?: string;
         includeArchived?: boolean;
@@ -152,19 +160,13 @@ export declare class Session {
         setEnabled: (enabled: boolean) => Promise<import("./types.js").MemoryView>;
     };
     send(content: string, options?: SendOptions): Promise<Run>;
-    enqueue(content: string, options?: SendOptions): Promise<{
-        status: string;
-        messageId: string;
-    }>;
+    enqueue(content: string, options?: SendOptions): Promise<import("../../shared/local-task-command.js").LocalTaskCommandResult>;
     queue(): Promise<import("./types.js").QueueSnapshot>;
-    editQueued(messageId: string, content: string, queueVersion: string, commandId?: `${string}-${string}-${string}-${string}-${string}`): Promise<unknown>;
-    removeQueued(messageId: string, snapshot: Pick<import('./types.js').QueueSnapshot, 'queueVersion' | 'activeRunId'>, commandId?: `${string}-${string}-${string}-${string}-${string}`): Promise<unknown>;
-    reorderQueue(messageIds: string[], queueVersion: string, commandId?: `${string}-${string}-${string}-${string}-${string}`): Promise<unknown>;
+    editQueued(messageId: string, content: string, queueVersion: string, commandId?: string): Promise<import("../../shared/local-task-command.js").LocalTaskCommandResult>;
+    removeQueued(messageId: string, snapshot: Pick<import('./types.js').QueueSnapshot, 'queueVersion' | 'activeRunId'>, commandId?: string): Promise<import("../../shared/local-task-command.js").LocalTaskCommandResult>;
+    reorderQueue(messageIds: string[], queueVersion: string, commandId?: string): Promise<import("../../shared/local-task-command.js").LocalTaskCommandResult>;
     /** A non-null targetRunId adds this message to that active run; null starts its own run. */
-    dispatchQueued(messageId: string, queueVersion: string, targetRunId: string | null, commandId?: `${string}-${string}-${string}-${string}-${string}`): Promise<{
-        status: string;
-        runId?: string;
-    }>;
+    dispatchQueued(messageId: string, queueVersion: string, targetRunId: string | null, commandId?: string): Promise<import("../../shared/local-task-command.js").LocalTaskCommandResult>;
     history(): Promise<import("../../shared/local-task-api.js").LocalTaskMessage[]>;
     rename(name: string, expectedRevision: string): Promise<SessionInfo>;
     setArchived(archived: boolean, expectedRevision: string): Promise<SessionInfo>;
@@ -212,7 +214,7 @@ export declare class Session {
     updateAgent(update: import('./types.js').SessionAgentUpdate): Promise<import("./types.js").SessionConfiguration>;
     receipt(commandId: string): Promise<import("./types.js").CommandReceipt>;
     resumeRun(runId: string): Run;
-    compact(): Promise<Run>;
+    compact(commandId?: string): Promise<Run>;
 }
 export declare class Run {
     private readonly transport;
@@ -238,11 +240,12 @@ export declare class Run {
     cancelOperation(operationId: string, options?: {
         signal?: AbortSignal;
     }): Promise<import("./types.js").TaskOperationSnapshot>;
-    cancel(): Promise<void>;
+    cancel(commandId?: string): Promise<void>;
     detach(): Promise<void>;
-    approve(toolCallId: string, decision: 'approve' | 'approve_for_session' | 'deny'): Promise<void>;
-    answer(requestId: string, response: Record<string, unknown>): Promise<void>;
-    confirmPlan(): Promise<Run>;
+    approve(toolCallId: string, decision: 'approve' | 'approve_for_session' | 'deny', commandId?: string): Promise<void>;
+    answer(requestId: string, response: Record<string, unknown>, commandId?: string): Promise<void>;
+    cancelInput(requestId: string, commandId?: string): Promise<void>;
+    confirmPlan(commandId?: string): Promise<Run>;
     /** Aborting observation never sends task cancellation. */
     events(options?: {
         cursor?: string;

package/dist/sdk/src/platform.d.ts

@@ -6,6 +6,7 @@ import type { PersonalUsageStatistics } from '../../shared/usage-statistics-api.
 import type { SkillMarketApi } from '../../shared/skill-market-api.js';
 import type { PluginMarketApi } from '../../shared/plugin-market-api.js';
 import type { EnterpriseKnowledgeApi } from '../../shared/enterprise-knowledge-api.js';
+import type { ExpertSelection, PreparedExpertAgent, ResolvedExpertSource } from '../../shared/expert-selection.js';
 /** Explicit platform queries, independent of the model's builtin tool permissions. */
 export declare class PlatformApi {
     private readonly connection;
@@ -19,6 +20,9 @@ export declare class PlatformApi {
         list: () => Promise<AvailableChatModel[]>;
         listSpeechRecognition: () => Promise<AvailableChatModel[]>;
     };
+    readonly experts: {
+        prepare: (selection: ExpertSelection, resolved?: ResolvedExpertSource) => Promise<PreparedExpertAgent>;
+    };
     readonly account: {
         getSummary: (query?: AccountContextQuery) => Promise<AccountContextSummary>;
         listPlanPurchases: () => Promise<AccountPlanPurchase[]>;

package/dist/sdk/src/product-resources.d.ts

@@ -0,0 +1,6 @@
+export interface ProductRuntimeResources {
+    root: string;
+    codexExecutable: string;
+}
+/** References are covered by the same signed manifest as the small SDK host. */
+export declare function validateProductResources(directory: string, value: unknown): Promise<ProductRuntimeResources>;

package/dist/sdk/src/runtime-integrity.d.ts

@@ -1,10 +1,12 @@
+import { type ProductRuntimeResources } from './product-resources.js';
 export interface VerifiedRuntime {
     version: string;
     protocol: number;
     dataFormat: number;
     platform: NodeJS.Platform;
     arch: string;
-    profile: 'light';
+    profile: 'light' | 'product';
     manifestSha256: string;
+    productResources?: ProductRuntimeResources;
 }
-export declare function validateSdkRuntimeDirectory(directory: string, trustedPublicKey?: string): Promise<VerifiedRuntime>;
+export declare function validateSdkRuntimeDirectory(directory: string, trustedPublicKey?: string, expectedTarget?: Pick<VerifiedRuntime, 'platform' | 'arch'>): Promise<VerifiedRuntime>;

package/dist/sdk/src/types.d.ts

@@ -1,7 +1,9 @@
+export type { TaskEvent, SessionEvent, SessionEventPage, EventObservationOptions, TaskInteraction, TaskMessage, HistoryQuery, HistoryPage, RunQuery, RunRecord, RunPage, RunState, QueueSnapshot } from '../../shared/sdk-session-contract.js';
 import type { BuiltinSelection, BuiltinSnapshot, CapabilityDescriptor } from '../../shared/agent-capabilities.js';
 import type { AuthSession, AuthPasswordChangeRequired } from '../../shared/desktop-api.js';
 import type { CredentialProvider, ManagedAuthentication } from '../../shared/managed-authorization.js';
 export type { TeamState, TeamMemberState, TeamTaskState, TeamCommand, TeamCommandResult } from '../../shared/team-control.js';
+export type { ExpertSelection, PreparedExpertAgent, ResolvedExpertSource } from '../../shared/expert-selection.js';
 export type { ManagedAuthentication, ManagedPrincipal, ManagedCredential, ManagedCredentialRequest, CredentialProvider, CredentialReason, ManagedAuthorizationEvent } from '../../shared/managed-authorization.js';
 export type { BuiltinSelection, BuiltinSnapshot, CapabilityDescriptor, ToolCategory, SkillCategory } from '../../shared/agent-capabilities.js';
 export type { AuthSession, PlatformUser, TenantSummary, LoginContext, AuthRequiredPasswordChangeRequest, AuthSwitchSubjectRequest } from '../../shared/desktop-api.js';
@@ -50,7 +52,6 @@ export interface RuntimeOptions {
     temporaryDirectory?: string;
     nodeExecutable?: string;
     tools?: Partial<Record<'node' | 'python' | 'git' | 'bash' | 'npm', string>>;
-    chromiumExecutable?: string;
     /** Override only for a runtime built and signed by your own organization. */
     trustedPublicKey?: string;
 }
@@ -272,6 +273,7 @@ export interface ClientConfiguration {
         contextDirectory: string;
         resourcesDirectory: string;
         tasksDirectory: string;
+        legacyTasksDirectory?: string;
         workspacesDirectory: string;
         temporaryDirectory: string;
         cacheDirectory: string;
@@ -290,43 +292,6 @@ export type LocalPreferenceDomain = import('../../cli/daemon/preferences.js').Pr
 export type { ComputerUseSettings } from '../../shared/computer-use-api.js';
 export type { NativeSettings, NativeCapabilityStatus } from './native-status.js';
 export type { MemoryView, MemoryEditRequest } from '../../shared/local-memory.js';
-export interface TaskEvent {
-    schemaVersion: 1;
-    /** Save after processing this event to resume without skipping the rest of its page. */
-    cursor: string;
-    sessionId: string;
-    id: string;
-    type: import('../../shared/local-task-api.js').LocalTaskEventType;
-    runId: string;
-    /** Sequence within this cursor stream; use the event ID for deduplication. */
-    sequence: number;
-    runtimeSequence?: number;
-    /** Original engine event kind; payload retains its full structured fields. */
-    runtimeType?: string;
-    threadId?: string;
-    turnId?: string;
-    itemId?: string;
-    requestId?: string;
-    rootThreadId?: string;
-    sourceThreadId?: string;
-    parentThreadId?: string;
-    /** Host-supplied business ownership; separate from local task/member/thread identifiers. */
-    context?: import('../../shared/execution-context.js').ExecutionContext;
-    payload: Record<string, unknown>;
-    createdAt?: string;
-}
-/** Includes session-level events without a run and late updates after a run completes. */
-export type SessionEvent = Omit<TaskEvent, 'runId'> & {
-    runId?: string;
-};
-export interface SessionEventPage {
-    events: SessionEvent[];
-    cursor: string;
-}
-export interface EventObservationOptions {
-    cursor?: string;
-    signal?: AbortSignal;
-}
 export interface SessionMemoryApi {
     get(request: import('../../shared/local-memory.js').MemoryContextRequest & {
         sessionId: string;
@@ -342,54 +307,6 @@ export interface SessionMemoryApi {
         enabled: boolean;
     }): Promise<import('../../shared/local-memory.js').MemoryView>;
 }
-export interface TaskInteraction {
-    id: string;
-    kind: string;
-    requestId: string;
-    runId: string;
-    status: string;
-    payload: Record<string, unknown>;
-}
-/** Same history contract consumed by the desktop renderer, including references, reasoning and usage. */
-export type TaskMessage = import('../../shared/local-task-api.js').LocalTaskMessage;
-export interface HistoryQuery {
-    text?: string;
-    around?: string;
-    cursor?: string;
-    limit?: number;
-}
-export interface HistoryPage {
-    items: TaskMessage[];
-    historyVersion: string;
-    hasMore: boolean;
-    nextCursor?: string;
-}
-export interface RunQuery {
-    cursor?: string;
-    limit?: number;
-}
-export interface RunRecord {
-    runId: string;
-    status: RunState['status'];
-    messageCount: number;
-    /** Journal timestamps; these do not claim the time a model request began. */
-    firstMessageAt?: string;
-    queuedAt?: string;
-    finishedAt?: string;
-    context?: import('../../shared/execution-context.js').ExecutionContext;
-}
-export interface RunPage {
-    items: RunRecord[];
-    revision: string;
-    hasMore: boolean;
-    nextCursor?: string;
-}
-export interface RunState {
-    status: 'queued' | 'running' | 'waiting' | 'completed' | 'failed' | 'cancelled' | 'interrupted';
-    runId: string;
-    interactions: TaskInteraction[];
-    messages: TaskMessage[];
-}
 export interface AuthTokens {
     accessToken: string;
     refreshToken: string;
@@ -448,6 +365,8 @@ export interface BrowserLoginStatus {
     };
 }
 export interface SendOptions extends Partial<ExecutionDefaults> {
+    /** Selected scene and its implicit resources, preserved in this turn's history and queue. */
+    sceneContext?: import('../../shared/local-task-api.js').LocalTaskSceneContext;
     /** Narrow this run's long-term memory access within the session grant. */
     memory?: import('../../shared/session-policy.js').RunMemoryPolicy;
     /** Trusted host metadata. Immutable for this run, including queued dispatch and continuations. */
@@ -466,13 +385,8 @@ export interface SendOptions extends Partial<ExecutionDefaults> {
     skills?: import('../../shared/local-task-api.js').LocalTaskSkillReference[];
     plugins?: import('../../shared/local-task-api.js').LocalTaskPluginReference[];
 }
-export interface QueueSnapshot {
-    messages: import('../../shared/local-task-api.js').LocalTaskPendingMessage[];
-    queueVersion: string;
-    activeRunId: string | null;
-    historyVersion: string;
-}
-export type CommandReceipt = import('../../shared/local-task-command.js').LocalTaskCommandRecord | null;
+export type CommandReceipt = import('../../shared/local-task-command.js').LocalTaskCommandReply | null;
+export type CommandResult = import('../../shared/local-task-command.js').LocalTaskCommandResult;
 export interface CapabilityQuery {
     kind?: 'tool' | 'skill';
     category?: string;

package/dist/shared/account-schedules-api.d.ts

@@ -0,0 +1,110 @@
+import type { AvailableChatModel } from './cloud-assistant-api.js';
+import type { PluginAuthorizationSaveRequest, PluginAuthorizationStatus } from './plugin-market-api.js';
+export type ScheduleTriggerType = 'ONCE' | 'DAILY' | 'CRON';
+export interface ScheduleTaskConfiguration {
+    model: string;
+    thinkingEnabled: boolean;
+    reasoningEffort?: 'low' | 'medium' | 'high' | 'xhigh' | null;
+    permissionMode: 'ask_dangerous' | 'allow_all';
+    memoryRead: boolean;
+    memoryWrite: boolean;
+    timeoutSeconds: number;
+    resources: {
+        skills: Record<string, string | null>[];
+        plugins: Record<string, string | null>[];
+    };
+}
+export interface WorkbenchSchedule {
+    scheduleId: string;
+    userId: string;
+    workspaceId: string;
+    taskConfiguration: ScheduleTaskConfiguration;
+    content: string;
+    triggerType: ScheduleTriggerType;
+    triggerAt: string;
+    timezone: string;
+    enabled: boolean;
+    createdAt: string | null;
+    updatedAt: string | null;
+}
+export interface WorkbenchScheduleRun {
+    runId: string;
+    scheduleId: string;
+    workspaceId: string;
+    taskId: string | null;
+    plannedTriggerAt: string;
+    triggerKey: string;
+    status: string;
+    resultContent: string | null;
+    errorMessage: string | null;
+    startedAt: string | null;
+    finishedAt: string | null;
+    createdAt: string | null;
+}
+export interface SaveScheduleRequest {
+    actorUserId: string;
+    workspaceId: string;
+    taskConfiguration: ScheduleTaskConfiguration;
+    content: string;
+    triggerType: ScheduleTriggerType;
+    triggerAt: string;
+    timezone: string;
+    enabled: boolean;
+}
+export type UpdateScheduleRequest = {
+    actorUserId: string;
+    scheduleId: string;
+} & Partial<Omit<SaveScheduleRequest, 'actorUserId'>>;
+export interface ScheduleListQuery {
+    actorUserId: string;
+    enabled?: boolean;
+    limit?: number;
+    offset?: number;
+}
+export interface ScheduleRunQuery {
+    actorUserId: string;
+    from: string;
+    before: string;
+    limit?: number;
+    offset?: number;
+}
+export interface SchedulePage<T> {
+    items: T[];
+    total: number;
+}
+export type TaskResourceScope = 'PLATFORM_SKILL' | 'ENTERPRISE_SKILL' | 'CREATED_SKILL' | 'INSTALLED_SKILL' | 'PLATFORM_PLUGIN' | 'ENTERPRISE_PLUGIN';
+export interface TaskSelectedResource {
+    kind: 'skill' | 'plugin';
+    name: string;
+    description: string;
+    selection: Record<string, string | null>;
+}
+export interface ScheduleResourceQuery {
+    actorUserId: string;
+    workspaceId: string;
+    scope: TaskResourceScope;
+    keyword: string;
+    page: number;
+}
+export interface AccountSchedulesApi {
+    list(query: ScheduleListQuery): Promise<SchedulePage<WorkbenchSchedule>>;
+    get(scheduleId: string, actorUserId: string): Promise<WorkbenchSchedule>;
+    create(request: SaveScheduleRequest): Promise<WorkbenchSchedule>;
+    update(request: UpdateScheduleRequest): Promise<WorkbenchSchedule>;
+    delete(scheduleId: string, actorUserId: string): Promise<void>;
+    listRuns(scheduleId: string, actorUserId: string, offset?: number): Promise<SchedulePage<WorkbenchScheduleRun>>;
+    listRunsByWindow(query: ScheduleRunQuery): Promise<SchedulePage<WorkbenchScheduleRun>>;
+    workspaces(actorUserId: string): Promise<{
+        id: string;
+        name: string;
+    }[]>;
+    models(actorUserId: string, workspaceId: string): Promise<AvailableChatModel[]>;
+    resources(query: ScheduleResourceQuery): Promise<{
+        list: TaskSelectedResource[];
+        hasNext: boolean;
+    }>;
+    selectResource(actorUserId: string, workspaceId: string, resource: TaskSelectedResource): Promise<TaskSelectedResource>;
+    getPluginAuthorization(actorUserId: string, workspaceId: string, pluginId: string): Promise<PluginAuthorizationStatus>;
+    savePluginAuthorization(actorUserId: string, workspaceId: string, pluginId: string, request: PluginAuthorizationSaveRequest): Promise<PluginAuthorizationStatus>;
+    verifyPluginAuthorization(actorUserId: string, workspaceId: string, pluginId: string): Promise<PluginAuthorizationStatus>;
+}

package/dist/shared/agent-team.d.ts

@@ -13,5 +13,7 @@ export interface AgentTeamMember {
 export interface AgentTeamDefinition {
     members: AgentTeamMember[];
     workflow?: string;
+    /** Validated platform package; keeps the desktop's roles, limits and write policy. */
+    package?: import('./expert-team-api.js').ExpertTeamRunSnapshot;
 }
 export declare function parseAgentTeam(value: unknown): AgentTeamDefinition;