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

package/dist/shared/sdk-session-contract.d.ts

@@ -0,0 +1,96 @@
+/** SDK schema version 1, shared by SDK clients and conversation renderers. No host runtime imports. */
+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('./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('./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 TaskInteraction {
+    id: string;
+    taskId?: string;
+    itemId?: string;
+    createdAt?: string;
+    updatedAt?: 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('./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('./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 QueueSnapshot {
+    messages: import('./local-task-api.js').LocalTaskPendingMessage[];
+    queueVersion: string;
+    activeRunId: string | null;
+    historyVersion: string;
+}

package/dist/shared/task-enterprise-project-api.d.ts

@@ -0,0 +1,75 @@
+export type JsonValue = null | boolean | number | string | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export interface EnterpriseProjectInteraction {
+    interaction_id: string;
+    type: 'approval' | 'single_select' | 'multi_select' | 'form' | 'text';
+    title: string;
+    description?: string | null;
+    details?: JsonValue;
+    options: {
+        id: string;
+        label: string;
+        value: JsonValue;
+    }[];
+    schema: JsonSchema;
+    expires_at?: string | null;
+    status: 'pending' | 'resolved' | 'expired';
+}
+export interface JsonSchema {
+    [keyword: string]: unknown;
+    type?: 'object' | 'array' | 'string' | 'number' | 'integer' | 'boolean' | 'null';
+    title?: string;
+    description?: string;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    enum?: JsonValue[];
+    minLength?: number;
+    maxLength?: number;
+    minimum?: number;
+    maximum?: number;
+    minItems?: number;
+    maxItems?: number;
+    pattern?: string;
+    format?: string;
+}
+export interface EnterpriseProjectArtifact {
+    name: string;
+    url: string;
+    mime_type?: string;
+}
+export interface EnterpriseProjectInvocation {
+    invocation_id: string;
+    record_id: string;
+    name: string;
+    task_id: string;
+    session_id: string;
+    status: 'queued' | 'running' | 'waiting_input' | 'waiting_approval' | 'succeeded' | 'incomplete' | 'failed' | 'cancelled' | 'interrupted';
+    result: JsonValue;
+    artifacts: EnterpriseProjectArtifact[];
+    required_action: EnterpriseProjectInteraction[];
+    error: JsonValue;
+    revision: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface EnterpriseProjectResource {
+    tenant_id: string;
+    workspace_id: string;
+    resource_type: 'AGENT' | 'AICODING_AGENT' | 'AICODING_WORKFLOW';
+    resource_id: string;
+}
+export interface EnterpriseProjectCapability extends EnterpriseProjectResource {
+    record_id: string;
+    name: string;
+    description?: string | null;
+    contract_revision: string;
+}
+export interface EnterpriseProjectCapabilityPage {
+    list: EnterpriseProjectCapability[];
+    page: number;
+    page_size: number;
+    has_next: boolean;
+    verification_pending: number;
+}

package/dist/shared/task-execution-api.d.ts

@@ -0,0 +1,35 @@
+export type TaskExecutionProvider = 'LICOS' | 'CLAUDE' | 'CODEX';
+export interface TaskExecutionEndpoint {
+    id: string;
+    name: string;
+    provider: TaskExecutionProvider;
+    status: 'PENDING' | 'ACTIVE' | 'REVOKED';
+    connected: boolean;
+    deviceId: string | null;
+    capabilities: {
+        protocolVersion?: number;
+        methods?: string[];
+    };
+}
+export interface TaskEndpointPairing {
+    id: string;
+    endpointId: string;
+    token: string;
+    expiresAt: string;
+}
+export interface TaskExecutionBinding {
+    endpointId: string;
+    deviceId: string;
+    provider: TaskExecutionProvider;
+    name: string;
+}
+export interface TaskExecutionEndpointsApi {
+    executionEndpoints(actor: string, offset: number): Promise<TaskExecutionEndpoint[]>;
+    createExecutionEndpoint(actor: string, name: string, provider: TaskExecutionProvider): Promise<TaskEndpointPairing>;
+    pairExecutionEndpoint(actor: string, id: string): Promise<TaskEndpointPairing>;
+    executionPairingStatus(actor: string, pair: TaskEndpointPairing): Promise<{
+        status: 'PENDING' | 'CLAIMED' | 'CANCELLED' | 'EXPIRED';
+    }>;
+    cancelExecutionPairing(actor: string, pair: TaskEndpointPairing): Promise<void>;
+    revokeExecutionEndpoint(actor: string, id: string): Promise<void>;
+}

package/package.json

@@ -1,22 +1,42 @@
 {
   "name": "@kmlckj/aios-agent-server-sdk",
-  "version": "0.0.1",
+  "version": "0.0.5",
   "description": "AIOS agent application SDK for Node.js",
   "type": "module",
-  "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org/" },
-  "engines": { "node": "^22.23.2 || ^24.0.0" },
-  "dependencies": { "ajv": "8.20.0", "tar": "7.5.22" },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": "^22.23.2 || ^24.0.0"
+  },
+  "dependencies": {
+    "ajv": "8.20.0",
+    "tar": "7.5.22"
+  },
   "optionalDependencies": {
-    "@kmlckj/aios-runtime-win32-x64": "0.0.1",
-    "@kmlckj/aios-runtime-darwin-x64": "0.0.1",
-    "@kmlckj/aios-runtime-darwin-arm64": "0.0.1",
-    "@kmlckj/aios-runtime-linux-x64": "0.0.1",
-    "@kmlckj/aios-runtime-linux-arm64": "0.0.1"
+    "@kmlckj/aios-runtime-win32-x64": "0.0.5",
+    "@kmlckj/aios-runtime-darwin-x64": "0.0.5",
+    "@kmlckj/aios-runtime-darwin-arm64": "0.0.5",
+    "@kmlckj/aios-runtime-linux-x64": "0.0.5",
+    "@kmlckj/aios-runtime-linux-arm64": "0.0.5"
   },
   "exports": {
-    ".": { "types": "./dist/sdk/src/index.d.ts", "import": "./dist/index.js" },
-    "./events": { "types": "./dist/sdk/src/events.d.ts", "import": "./dist/events.js" }
+    ".": {
+      "types": "./dist/sdk/src/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./events": {
+      "types": "./dist/sdk/src/events.d.ts",
+      "import": "./dist/events.js"
+    }
   },
-  "files": ["dist", "README.md", "EVENTS.md", "examples", "capabilities.json"],
+  "files": [
+    "dist",
+    "README.md",
+    "EVENTS.md",
+    "examples",
+    "capabilities.json"
+  ],
   "license": "UNLICENSED"
 }

package/dist/shared/cloud-task-event-api.d.ts

@@ -1,22 +0,0 @@
-import type { CloudTaskEvent, CloudTaskEventSubscriptionRequest } from './collaboration-task-api.js';
-export interface CloudTaskEventSubscription {
-    subscriptionId: string;
-}
-export type CloudTaskEventStreamMessage = {
-    type: 'event';
-    subscriptionId: string;
-    generation: number;
-    event: CloudTaskEvent;
-} | {
-    type: 'connection';
-    subscriptionId: string;
-    generation: number;
-    state: 'connecting' | 'connected' | 'recovering' | 'closed';
-    lastSeqId: number;
-    reason?: string;
-};
-export interface CloudTaskEventApi {
-    subscribe(request: CloudTaskEventSubscriptionRequest): Promise<CloudTaskEventSubscription>;
-    unsubscribe(subscriptionId: string): Promise<void>;
-    onEvent(listener: (message: CloudTaskEventStreamMessage) => void): () => void;
-}