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

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/action-center-api.d.ts

@@ -0,0 +1,50 @@
+export interface ActionCenterSummary {
+    todoPendingCount: number;
+    messageUnreadCount: number;
+    announcementUnreadCount: number;
+}
+export interface ActionCenterTarget {
+    targetType: string | null;
+    targetRoute: string | null;
+    targetUrl: string | null;
+    openMode: string | null;
+}
+export interface ActionCenterMessage {
+    id: string;
+    sourceAppId: string | null;
+    sourceModule: string | null;
+    category: string | null;
+    level: string | null;
+    title: string;
+    content: string | null;
+    readStatus: string;
+    publishedAt: string | null;
+    createdAt: string | null;
+    target: ActionCenterTarget | null;
+    businessType?: string | null;
+    businessId?: string | null;
+    status?: string | null;
+    payload?: Record<string, unknown> | null;
+}
+export interface ActionCenterMessageQuery {
+    page: number;
+    pageSize: number;
+    readStatus?: 'unread';
+}
+export interface ActionCenterMessagePage {
+    list: ActionCenterMessage[];
+    page: number;
+    pageSize: number;
+    total: number;
+}
+export interface ActionCenterNavigation {
+    url: string;
+    openMode: string | null;
+}
+export interface ActionCenterApi {
+    getSummary: () => Promise<ActionCenterSummary>;
+    listMessages: (query: ActionCenterMessageQuery) => Promise<ActionCenterMessagePage>;
+    markMessageRead: (messageId: string) => Promise<void>;
+    markAllMessagesRead: () => Promise<void>;
+    openMessageTarget: (messageId: string) => Promise<void>;
+}

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

@@ -0,0 +1,42 @@
+/** Public capability IDs are independent of transport names and permissions. */
+export declare const TOOL_CATEGORIES: readonly ["workspace", "process", "repository", "web", "documents", "data", "media", "knowledge", "memory", "task-coordination", "automation", "computer", "extensions"];
+export declare const SKILL_CATEGORIES: readonly ["development", "documents", "data-research", "design", "media", "business", "automation", "agent-building"];
+export type ToolCategory = typeof TOOL_CATEGORIES[number];
+export type SkillCategory = typeof SKILL_CATEGORIES[number];
+export type AgentRuntimeMode = 'platform' | 'standalone';
+export interface CapabilitySelection<Category extends string = string> {
+    categories?: readonly Category[];
+    include?: readonly string[];
+    exclude?: readonly string[];
+}
+export interface BuiltinSelection {
+    /** AIOS-provided tools only; false leaves them unregistered. Engine tools are unchanged. */
+    tools?: boolean | CapabilitySelection<ToolCategory>;
+    /** AIOS-provided skills only; false skips materialization, discovery and injection. */
+    skills?: boolean | CapabilitySelection<SkillCategory>;
+}
+export interface CapabilityDescriptor<Category extends string = string> {
+    id: string;
+    kind: 'tool' | 'skill';
+    category: Category;
+    source: 'builtin' | 'platform' | 'application' | 'local';
+    integration: 'dynamic' | 'mcp' | 'skill';
+    requiresPlatform: boolean;
+    dependencies: readonly string[];
+    tags: readonly string[];
+    supported: boolean;
+    unavailableReason?: string;
+}
+export interface BuiltinSnapshot {
+    catalogVersion: 1;
+    mode: AgentRuntimeMode;
+    tools: string[];
+    skills: string[];
+}
+/** A saved list is the ceiling. New catalog members never expand an old task. */
+export declare function selectCapabilities<C extends string>(selection: boolean | CapabilitySelection<C>, catalog: readonly CapabilityDescriptor<C>[], categories: readonly C[], mode: AgentRuntimeMode, parent?: readonly string[]): string[];
+export declare function resolveBuiltinSnapshot(mode: AgentRuntimeMode, selection: BuiltinSelection, catalog: readonly CapabilityDescriptor[], parent?: BuiltinSnapshot): BuiltinSnapshot;
+export declare const BUILTIN_SKILL_GROUPS: Readonly<Record<SkillCategory, readonly string[]>>;
+/** Prefix families come from named registries; arbitrary extension tools never enter here. */
+export declare function describeBuiltinTool(name: string, integration: CapabilityDescriptor['integration']): CapabilityDescriptor<ToolCategory>;
+export declare const BUILTIN_SKILL_CATALOG: CapabilityDescriptor<SkillCategory>[];

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

@@ -0,0 +1,10 @@
+/** Host-owned lifecycle commands. They receive one JSON event on stdin and return hook JSON on stdout. */
+export interface AgentCommandHook {
+    event: 'UserPromptSubmit' | 'PreToolUse' | 'PostToolUse' | 'PreCompact' | 'PostCompact' | 'SessionStart' | 'SessionEnd' | 'SubagentStart' | 'SubagentStop' | 'Stop' | 'Interrupt';
+    command: string;
+    commandWindows?: string;
+    matcher?: string;
+    /** Hook execution limit only; this does not impose a task deadline. */
+    timeoutSeconds: number;
+}
+export declare function parseAgentHooks(value: unknown): AgentCommandHook[];

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

@@ -0,0 +1,19 @@
+import { type TaskPathPolicy } from './task-path-policy.js';
+import { type ModelReasoningEffort } from './model-selection.js';
+export interface AgentTeamMember {
+    id: string;
+    name: string;
+    instructions: string;
+    model?: string;
+    reasoningEffort?: ModelReasoningEffort;
+    /** AIOS tool names, intersected with the parent selection. Native tools remain constrained by the filesystem policy. */
+    tools?: string[];
+    paths?: TaskPathPolicy;
+}
+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;

package/dist/shared/artifact-evidence.d.ts

@@ -0,0 +1,18 @@
+export interface ArtifactVerification {
+    tool: string;
+    at: string;
+    fileVersion?: string;
+    origin?: 'tool_reported' | 'file_registration';
+    action?: string;
+    coverage?: Record<string, unknown>;
+}
+/** Evidence concerns only the reported checks, never a platform business verdict. */
+export interface ArtifactEvidence {
+    path: string;
+    threadId: string;
+    reportedVerified: boolean;
+    validity: 'current' | 'stale' | 'unversioned';
+    verification: ArtifactVerification;
+    previousVerification?: ArtifactVerification;
+    invalidation?: string;
+}

package/dist/shared/automation-api.d.ts

@@ -0,0 +1,112 @@
+import type { LocalTaskPermissionMode, LocalTaskPluginReference, LocalTaskSkillReference } from './local-task-api.js';
+import type { ModelReasoningEffort } from './model-selection.js';
+export type AutomationStatus = 'active' | 'paused';
+export type AutomationRunKind = 'scheduled' | 'missed' | 'manual_test';
+export type AutomationRunStatus = 'queued' | 'waiting_login' | 'running' | 'completed' | 'failed' | 'interrupted' | 'skipped';
+export type AutomationRunFilter = 'all' | 'completed' | 'failed' | 'running' | 'archived';
+export type AutomationRemoveMode = 'reject_if_running' | 'keep_running' | 'stop_running';
+export type AutomationSchedule = {
+    type: 'recurring';
+    frequency: 'daily' | 'weekdays' | 'weekly' | 'monthly';
+    time: string;
+    daysOfWeek?: number[];
+    dayOfMonth?: number;
+} | {
+    type: 'interval';
+    intervalMinutes: number;
+    anchorAt: string;
+    daysOfWeek?: number[];
+} | {
+    type: 'once';
+    runAt: string;
+};
+export interface DesktopAutomation {
+    id: string;
+    name: string;
+    prompt: string;
+    workspacePaths: string[];
+    model?: string;
+    thinkingEnabled: boolean;
+    reasoningEffort: ModelReasoningEffort | undefined;
+    skills: LocalTaskSkillReference[];
+    plugins: LocalTaskPluginReference[];
+    permissionMode: LocalTaskPermissionMode;
+    schedule: AutomationSchedule;
+    timezone: string;
+    validFrom?: string;
+    validUntil?: string;
+    status: AutomationStatus;
+    nextRunAt?: string;
+    lastRunAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AutomationRunTarget {
+    workspacePath?: string;
+    taskId?: string;
+    runId?: string;
+    status: 'queued' | 'running' | 'completed' | 'failed' | 'interrupted' | 'skipped';
+    error?: string;
+}
+export interface AutomationExecutionSnapshot {
+    prompt: string;
+    model?: string;
+    thinkingEnabled: boolean;
+    reasoningEffort: ModelReasoningEffort | undefined;
+    skills: LocalTaskSkillReference[];
+    plugins: LocalTaskPluginReference[];
+    permissionMode: LocalTaskPermissionMode;
+}
+export interface AutomationRun {
+    id: string;
+    automationId: string;
+    automationName: string;
+    scheduleSlotId: string;
+    scheduledAt: string;
+    runKind: AutomationRunKind;
+    status: AutomationRunStatus;
+    configuration?: AutomationExecutionSnapshot;
+    taskIds: string[];
+    targets: AutomationRunTarget[];
+    error?: string;
+    archivedAt?: string;
+    createdAt: string;
+    startedAt?: string;
+    completedAt?: string;
+    updatedAt: string;
+}
+export interface SaveAutomationRequest {
+    id?: string;
+    name: string;
+    prompt: string;
+    workspacePaths: string[];
+    model?: string;
+    thinkingEnabled?: boolean;
+    reasoningEffort?: ModelReasoningEffort;
+    skills: LocalTaskSkillReference[];
+    plugins: LocalTaskPluginReference[];
+    permissionMode: LocalTaskPermissionMode;
+    schedule: AutomationSchedule;
+    timezone: string;
+    validFrom?: string;
+    validUntil?: string;
+    status?: AutomationStatus;
+}
+export interface ListAutomationRunsQuery {
+    automationId?: string;
+    filter?: AutomationRunFilter;
+    keyword?: string;
+    limit?: number;
+}
+export interface AutomationApi {
+    list: () => Promise<DesktopAutomation[]>;
+    get: (automationId: string) => Promise<DesktopAutomation>;
+    save: (request: SaveAutomationRequest) => Promise<DesktopAutomation>;
+    setPaused: (automationId: string, paused: boolean) => Promise<DesktopAutomation>;
+    remove: (automationId: string, mode?: AutomationRemoveMode) => Promise<void>;
+    runNow: (automationId: string) => Promise<AutomationRun>;
+    listRuns: (query?: ListAutomationRunsQuery) => Promise<AutomationRun[]>;
+    archiveRun: (runId: string, archived: boolean) => Promise<AutomationRun>;
+    removeRun: (runId: string) => Promise<void>;
+    onChanged: (listener: () => void) => () => void;
+}

package/dist/shared/client-downloads-api.d.ts

@@ -0,0 +1,20 @@
+export declare const CLIENT_DOWNLOAD_PLATFORMS: readonly ["IOS", "ANDROID", "WINDOWS", "MACOS_INTEL", "MACOS_APPLE_SILICON"];
+export type ClientDownloadPlatform = (typeof CLIENT_DOWNLOAD_PLATFORMS)[number];
+export interface CurrentClientRelease {
+    id: string;
+    platform: ClientDownloadPlatform;
+    version: string;
+    downloadUrl: string;
+    minimumOsVersion?: string | null;
+    fileSizeBytes?: number | null;
+    publishedAt?: string | null;
+    activatedAt?: string | null;
+}
+export interface ClientDownloadCatalog {
+    releases: CurrentClientRelease[];
+    mobileDownloadUrl: string;
+    recommendedDesktopPlatform: Extract<ClientDownloadPlatform, 'WINDOWS' | 'MACOS_INTEL' | 'MACOS_APPLE_SILICON'> | null;
+}
+export interface ClientDownloadsApi {
+    getCatalog: () => Promise<ClientDownloadCatalog>;
+}