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

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/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;
 }
@@ -290,43 +291,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 +306,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 +364,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 +384,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;