@rynx-ai/workspace 0.1.9

package/dist/types.d.ts

@@ -0,0 +1,824 @@
+/** Workspace-plane API wire DTOs and dependency injection contracts. */
+import type { WorkspaceDeviceTaskResult, WorkspaceLeasedDeviceTask, WorkspaceSkillArtifact, WorkspaceTaskFinishDisposition } from "./device-protocol.js";
+import type { WorkspaceAgentRuntimeId } from "./agent-options.js";
+import type { WorkspaceAgentSchedulerPlane } from "./agent-scheduler.js";
+import type { WorkspaceAgentRun, WorkspaceAppendAgentRunTurnInput, WorkspaceAppendAgentRunTurnResult, WorkspaceAgentRunDetail, WorkspaceAgentRunEvent, WorkspaceAgentRunOrigin, WorkspaceAgentRunStatus, WorkspaceAgentRunTurnPage, WorkspaceCreateAgentRunInput, WorkspaceCreateAgentRunResult, WorkspaceResolveBlockedAgentRunInput, WorkspaceResolveBlockedAgentRunResult, WorkspaceResolveAgentInteractionInput, WorkspaceResolveAgentInteractionResult } from "./agent-execution.js";
+export interface WorkspaceAuthUser {
+    openId: string;
+    unionId?: string;
+    userId?: string;
+    name?: string;
+    email?: string;
+    avatarUrl?: string;
+}
+export interface WorkspaceAuthState {
+    provider: "lark";
+    authenticated: boolean;
+    configured?: boolean;
+    user?: WorkspaceAuthUser;
+    errorCode?: "workspace_auth_not_configured" | "workspace_auth_unavailable" | "workspace_server_unavailable";
+    error?: string;
+}
+export interface WorkspaceAuthSession extends WorkspaceAuthUser {
+    id: string;
+    createdAt: string;
+    expiresAt: string;
+    lastSeenAt?: string;
+}
+export interface WorkspaceAuthSessionStore {
+    create(session: WorkspaceAuthSession): void | Promise<void>;
+    get(id: string): WorkspaceAuthSession | null | Promise<WorkspaceAuthSession | null>;
+    touch(id: string, seenAt: string): void | Promise<void>;
+    delete(id: string): void | Promise<void>;
+    cleanupExpired?(now: string): void | Promise<void>;
+}
+export interface WorkspaceView {
+    id: string;
+    name: string;
+    kind: "shared" | "personal";
+    visibility: "public";
+    ownerOpenId?: string;
+    ownerName?: string;
+    createdByOpenId?: string;
+    createdByName?: string;
+    createdAt: string;
+    updatedAt?: string;
+}
+export interface WorkspaceDeviceCredential {
+    id: string;
+    serverId: string;
+    workspaceId: string;
+    audience: string;
+    installationId: string;
+    publicKey: string;
+    generation: number;
+    status: "pending" | "active" | "revoked";
+    authorizationSource: "lark" | "internal" | "legacy";
+    scopes: string[];
+    name: string;
+    tokenPrefix: string;
+    createdByOpenId?: string;
+    createdByName?: string;
+    createdAt: string;
+    expiresAt?: string;
+    lastUsedAt?: string;
+}
+/** Server-scoped authorization used only to discover Workspaces and mint child device credentials. */
+export interface WorkspaceDeviceAccessToken {
+    id: string;
+    serverId: string;
+    audience: string;
+    installationId: string;
+    publicKey: string;
+    generation: number;
+    authorizationSource: "session" | "enrollment";
+    scopes: string[];
+    name: string;
+    tokenPrefix: string;
+    createdByOpenId: string;
+    createdByName?: string;
+    createdAt: string;
+    lastUsedAt?: string;
+}
+export interface WorkspaceDeviceAccessSummary extends WorkspaceDeviceAccessToken {
+    status: "active" | "superseded" | "disabled";
+    disabledAt?: string;
+}
+export interface WorkspaceInstallationState {
+    installationId: string;
+    publicKey: string;
+    disabledAt?: string;
+}
+/** @deprecated Use WorkspaceDeviceCredential. Kept as a source-compatible wire alias. */
+export type WorkspaceApiToken = WorkspaceDeviceCredential;
+export interface WorkspaceDevice {
+    id: string;
+    workspaceId: string;
+    installationId: string;
+    name: string;
+    hostname?: string;
+    platform?: string;
+    arch?: string;
+    registeredByOpenId?: string;
+    registeredByName?: string;
+    credentialId?: string;
+    createdAt: string;
+    updatedAt: string;
+    lastSeenAt: string;
+    connected: boolean;
+    runtimes: WorkspaceRuntime[];
+}
+export interface WorkspaceRuntime {
+    id: string;
+    workspaceId: string;
+    deviceId: string;
+    runtime: string;
+    displayName: string;
+    binary?: string;
+    version?: string;
+    /** Model catalogue reported by this exact device runtime. */
+    models: WorkspaceAgentModelOption[];
+    status: "online" | "offline";
+    createdAt: string;
+    updatedAt: string;
+    lastSeenAt: string;
+}
+export interface WorkspaceRepository {
+    id: string;
+    workspaceId: string;
+    name: string;
+    gitUrl: string;
+    defaultBranch?: string;
+    kind: "remote" | "device_local" | "hybrid";
+    tags: string[];
+    locations: WorkspaceRepositoryLocation[];
+    createdByOpenId?: string;
+    createdByName?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface WorkspaceRepositoryLocation {
+    id: string;
+    workspaceId: string;
+    repositoryId: string;
+    deviceId: string;
+    deviceName?: string;
+    path: string;
+    gitUrl?: string;
+    branch?: string;
+    headSha?: string;
+    isWorktree?: boolean;
+    sizeBytes?: number;
+    status: "available" | "missing" | "stale";
+    lastScannedAt: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface WorkspaceRepositoryCandidate {
+    id: string;
+    workspaceId: string;
+    deviceId: string;
+    deviceName?: string;
+    path: string;
+    name: string;
+    gitUrl?: string;
+    branch?: string;
+    headSha?: string;
+    isWorktree?: boolean;
+    sizeBytes?: number;
+    tags: string[];
+    lastScannedAt: string;
+}
+export interface WorkspaceRepositoryPathRequest {
+    id: string;
+    workspaceId: string;
+    deviceId: string;
+    deviceName?: string;
+    path: string;
+    status: "pending" | "running" | "found" | "invalid";
+    lastError?: string;
+    requestedByOpenId?: string;
+    requestedByName?: string;
+    createdAt: string;
+    updatedAt: string;
+    lastCheckedAt?: string;
+}
+export type WorkspaceAgentPlacement = {
+    mode: "auto";
+} | {
+    mode: "fixed";
+    deviceId: string;
+};
+/** An exact immutable Skill revision referenced by an Agent revision. */
+export interface WorkspaceAgentSkillRevisionRef {
+    skillId: string;
+    skillRevisionId: string;
+    revisionNumber: number;
+    name: string;
+    description?: string;
+    contentHash: string;
+    fileCount: number;
+}
+export interface WorkspaceAgentRevision {
+    id: string;
+    workspaceId: string;
+    agentId: string;
+    revisionNumber: number;
+    name: string;
+    description?: string;
+    instructions: string;
+    runtime: WorkspaceAgentRuntimeId;
+    placement: WorkspaceAgentPlacement;
+    model: string;
+    reasoningEffort?: string;
+    skillRevisions: WorkspaceAgentSkillRevisionRef[];
+    createdByOpenId?: string;
+    createdByName?: string;
+    createdAt: string;
+}
+/** Stable Agent identity. Editable execution configuration lives in currentRevision. */
+export interface WorkspaceAgent {
+    id: string;
+    workspaceId: string;
+    createdByOpenId?: string;
+    createdByName?: string;
+    createdAt: string;
+    updatedAt: string;
+    archivedAt?: string;
+    currentRevision: WorkspaceAgentRevision;
+}
+export interface WorkspaceAgentRevisionInput {
+    name: string;
+    description?: string;
+    instructions: string;
+    runtime: WorkspaceAgentRuntimeId;
+    placement: WorkspaceAgentPlacement;
+    model: string;
+    reasoningEffort?: string;
+    skillRevisionIds: string[];
+}
+export interface WorkspaceCreateAgentInput extends WorkspaceAgentRevisionInput {
+    workspaceId: string;
+    createdBy?: WorkspaceAuthUser;
+}
+export interface WorkspaceUpdateAgentInput extends WorkspaceAgentRevisionInput {
+    workspaceId: string;
+    agentId: string;
+    expectedRevisionId: string;
+    updatedBy?: WorkspaceAuthUser;
+}
+export interface WorkspaceArchiveAgentInput {
+    workspaceId: string;
+    agentId: string;
+    expectedRevisionId: string;
+    archivedBy?: WorkspaceAuthUser;
+}
+export type WorkspaceAgentMutationInvalidCode = "invalid_input" | "invalid_runtime" | "invalid_device" | "invalid_skill_revision";
+export type WorkspaceAgentMutationResult = {
+    status: "created" | "updated" | "archived";
+    agent: WorkspaceAgent;
+} | {
+    status: "not_found";
+} | {
+    status: "revision_conflict";
+    currentRevisionId: string;
+} | {
+    status: "invalid";
+    code: WorkspaceAgentMutationInvalidCode;
+    error: string;
+};
+export type WorkspaceSkillSourceType = "agentbuddy" | "github" | "local-runtime" | "archive" | "manual";
+export type WorkspaceSkillImportConflictMode = "fail" | "overwrite" | "rename" | "skip";
+export type WorkspaceSkillImportStatus = "created" | "updated" | "conflict" | "skipped" | "failed";
+export type WorkspaceSkillRuntimeKind = WorkspaceAgentRuntimeId;
+export interface WorkspaceSkillRevisionFileEntry {
+    path: string;
+    sizeBytes: number;
+    sha256: string;
+}
+/** Stable Skill identity. Skill names and bytes are immutable revision data. */
+export interface WorkspaceSkill {
+    id: string;
+    workspaceId: string;
+    createdByOpenId?: string;
+    createdByName?: string;
+    createdAt: string;
+    updatedAt: string;
+    archivedAt?: string;
+}
+export interface WorkspaceSkillRevision {
+    id: string;
+    workspaceId: string;
+    skillId: string;
+    revisionNumber: number;
+    name: string;
+    description?: string;
+    sourceType: WorkspaceSkillSourceType;
+    sourceUrl?: string;
+    sourceRuntime?: WorkspaceSkillRuntimeKind;
+    sourceRuntimeId?: string;
+    sourceDeviceId?: string;
+    sourceDeviceName?: string;
+    sourcePath?: string;
+    contentHash: string;
+    fileCount: number;
+    createdByOpenId?: string;
+    createdByName?: string;
+    createdAt: string;
+}
+export interface WorkspaceSkillRevisionDetail extends WorkspaceSkillRevision {
+    files: WorkspaceSkillRevisionFileEntry[];
+}
+export interface WorkspaceSkillSummary extends WorkspaceSkill {
+    currentRevision: WorkspaceSkillRevision;
+}
+export interface WorkspaceSkillDetail extends WorkspaceSkill {
+    currentRevision: WorkspaceSkillRevisionDetail;
+}
+/** Complete immutable file bytes. contentBase64 is never truncated. */
+export interface WorkspaceSkillRevisionFile extends WorkspaceSkillRevisionFileEntry {
+    workspaceId: string;
+    skillId: string;
+    skillRevisionId: string;
+    contentBase64: string;
+}
+export interface WorkspaceSkillRevisionFileInput {
+    path: string;
+    contentBase64: string;
+}
+export interface WorkspaceSkillRevisionInput {
+    name: string;
+    description?: string;
+    sourceType: WorkspaceSkillSourceType;
+    sourceUrl?: string;
+    sourceRuntime?: WorkspaceSkillRuntimeKind;
+    sourceRuntimeId?: string;
+    sourceDeviceId?: string;
+    sourceDeviceName?: string;
+    sourcePath?: string;
+    files: WorkspaceSkillRevisionFileInput[];
+}
+export interface WorkspaceCreateSkillInput extends WorkspaceSkillRevisionInput {
+    workspaceId: string;
+    createdBy?: WorkspaceAuthUser;
+}
+export interface WorkspaceUpdateSkillInput extends WorkspaceSkillRevisionInput {
+    workspaceId: string;
+    skillId: string;
+    expectedRevisionId: string;
+    updatedBy?: WorkspaceAuthUser;
+}
+export interface WorkspaceArchiveSkillInput {
+    workspaceId: string;
+    skillId: string;
+    expectedRevisionId: string;
+    archivedBy?: WorkspaceAuthUser;
+}
+export type WorkspaceSkillMutationInvalidCode = "invalid_input" | "invalid_file" | "invalid_source";
+export type WorkspaceSkillMutationResult = {
+    status: "created" | "updated" | "archived";
+    skill: WorkspaceSkillSummary;
+} | {
+    status: "not_found";
+} | {
+    status: "revision_conflict";
+    currentRevisionId: string;
+} | {
+    status: "invalid";
+    code: WorkspaceSkillMutationInvalidCode;
+    error: string;
+};
+export interface WorkspaceRuntimeSkillCandidate {
+    key: string;
+    name: string;
+    description?: string;
+    deviceId?: string;
+    deviceName?: string;
+    runtimeId?: string;
+    runtimeDisplayName?: string;
+    sourceRuntime: WorkspaceSkillRuntimeKind;
+    sourcePath: string;
+    root: "provider" | "universal";
+    fileCount: number;
+    sizeBytes: number;
+}
+export interface WorkspaceSkillImportResult {
+    status: WorkspaceSkillImportStatus;
+    name: string;
+    skill?: WorkspaceSkillSummary;
+    sourceType?: WorkspaceSkillSourceType;
+    sourcePath?: string;
+    message?: string;
+}
+export interface WorkspaceSkillFilePayload {
+    path: string;
+    /** UTF-8 text, or base64 when `binary` is true. */
+    content: string;
+    sizeBytes: number;
+    binary?: boolean;
+    truncated?: boolean;
+    hash?: string;
+}
+export interface WorkspaceSkillImportBundle {
+    name: string;
+    description?: string;
+    sourcePath: string;
+    contentHash: string;
+    files: WorkspaceSkillFilePayload[];
+}
+export interface WorkspaceSkillRuntimeScanRequest {
+    id: string;
+    workspaceId: string;
+    deviceId: string;
+    runtimeId: string;
+    runtime: WorkspaceSkillRuntimeKind;
+    status: "pending" | "running" | "completed" | "failed";
+    candidates: WorkspaceRuntimeSkillCandidate[];
+    error?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface WorkspaceSkillRuntimeImportRequest {
+    id: string;
+    workspaceId: string;
+    deviceId: string;
+    runtimeId: string;
+    runtime: WorkspaceSkillRuntimeKind;
+    status: "pending" | "running" | "completed" | "failed";
+    results: WorkspaceSkillImportResult[];
+    error?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface WorkspaceDeviceSkillRuntimeScanTask {
+    id: string;
+    workspaceId: string;
+    deviceId: string;
+    runtimeId: string;
+    runtime: WorkspaceSkillRuntimeKind;
+}
+export interface WorkspaceDeviceSkillRuntimeImportTask extends WorkspaceDeviceSkillRuntimeScanTask {
+    keys: string[];
+}
+export interface WorkspaceDeviceSkillRuntimeScanReport {
+    requestId: string;
+    runtimeId: string;
+    runtime: WorkspaceSkillRuntimeKind;
+    candidates?: WorkspaceRuntimeSkillCandidate[];
+    error?: string;
+}
+export interface WorkspaceDeviceSkillRuntimeImportReport {
+    requestId: string;
+    runtimeId: string;
+    runtime: WorkspaceSkillRuntimeKind;
+    skills?: WorkspaceSkillImportBundle[];
+    failures?: WorkspaceSkillImportResult[];
+    error?: string;
+}
+export interface WorkspaceDeviceSkillArtifactBundle {
+    id: string;
+    skillRevisionId: string;
+    name: string;
+    description?: string;
+    contentHash: string;
+    files: WorkspaceSkillFilePayload[];
+}
+export interface WorkspaceDeviceSkillArtifactRef {
+    id: string;
+    skillRevisionId: string;
+    name: string;
+    description?: string;
+    contentHash: string;
+}
+export interface WorkspaceAgentModelOption {
+    id: string;
+    label: string;
+    description?: string;
+    isDefault?: boolean;
+    supportedReasoningEfforts?: WorkspaceAgentReasoningOption[];
+    defaultReasoningEffort?: string;
+}
+export interface WorkspaceAgentReasoningOption {
+    value: string;
+    label: string;
+    description?: string;
+}
+export interface WorkspaceRuntimeRegistration {
+    runtime: string;
+    displayName?: string;
+    binary?: string;
+    version?: string;
+    models?: WorkspaceAgentModelOption[];
+    status?: "online" | "offline";
+}
+export interface WorkspaceRepositoryScanResult {
+    path: string;
+    name?: string;
+    gitUrl?: string;
+    branch?: string;
+    headSha?: string;
+    isWorktree?: boolean;
+    sizeBytes?: number;
+    tags?: string[];
+}
+export interface WorkspaceDeviceIdentity {
+    name: string;
+    hostname: string;
+    platform: string;
+    arch: string;
+}
+export interface WorkspaceDeviceInventory {
+    digest: string;
+    runtimes: WorkspaceRuntimeRegistration[];
+    repositories: WorkspaceRepositoryScanResult[];
+}
+export interface WorkspacePlaneDeps extends WorkspaceAgentSchedulerPlane {
+    serverId(): string;
+    listWorkspaces(user?: WorkspaceAuthUser): WorkspaceView[];
+    createWorkspace(input: {
+        name: string;
+        createdBy?: WorkspaceAuthUser;
+    }): WorkspaceView;
+    ensurePersonalWorkspace(user: WorkspaceAuthUser): Promise<WorkspaceView> | WorkspaceView;
+    workspaceExists(id: string): boolean;
+    workspaceAccessible(input: {
+        workspaceId: string;
+        user?: WorkspaceAuthUser;
+    }): boolean;
+    installationState(installationId: string): WorkspaceInstallationState | null;
+    completeDeviceAccessToken(input: {
+        serverId: string;
+        audience: string;
+        installationId: string;
+        publicKey: string;
+        name: string;
+        accessToken: string;
+        authorizationSource: "session" | "enrollment";
+        createdBy: WorkspaceAuthUser;
+    }): {
+        status: "issued";
+        access: WorkspaceDeviceAccessToken;
+        revokedCredentialIds: string[];
+    } | {
+        status: "key_mismatch";
+    } | {
+        status: "installation_disabled";
+    };
+    listDeviceAccess(user: WorkspaceAuthUser): WorkspaceDeviceAccessSummary[];
+    revokeDeviceAccess(input: {
+        installationId: string;
+        user: WorkspaceAuthUser;
+    }): {
+        revoked: boolean;
+        revokedCredentialIds: string[];
+    };
+    authenticateDeviceAccessToken(rawToken: string): WorkspaceDeviceAccessToken | null | Promise<WorkspaceDeviceAccessToken | null>;
+    createApiTokenFromDeviceAccess(input: {
+        access: WorkspaceDeviceAccessToken;
+        workspaceId: string;
+        name?: string;
+    }): {
+        token: WorkspaceApiToken;
+        rawToken: string;
+        revokedTokenIds: string[];
+    } | null;
+    listApiTokens(input: {
+        workspaceId: string;
+        user?: WorkspaceAuthUser;
+    }): WorkspaceApiToken[];
+    createApiToken(input: {
+        serverId: string;
+        workspaceId: string;
+        audience: string;
+        installationId: string;
+        publicKey: string;
+        name: string;
+        createdBy?: WorkspaceAuthUser;
+    }): {
+        token: WorkspaceApiToken;
+        rawToken: string;
+        revokedTokenIds: string[];
+    };
+    revokeApiToken(input: {
+        id: string;
+        workspaceId: string;
+        user?: WorkspaceAuthUser;
+    }): boolean;
+    authenticateApiToken(rawToken: string): WorkspaceApiToken | null | Promise<WorkspaceApiToken | null>;
+    isApiTokenActive(token: WorkspaceApiToken): boolean | Promise<boolean>;
+    listDevices(workspaceId: string): WorkspaceDevice[];
+    connectDevice(input: {
+        installationId: string;
+        identity: WorkspaceDeviceIdentity;
+        token: WorkspaceApiToken;
+    }): {
+        device: WorkspaceDevice;
+        activatedCredentialId: string;
+        revokedCredentialIds: string[];
+    } | null | Promise<{
+        device: WorkspaceDevice;
+        activatedCredentialId: string;
+        revokedCredentialIds: string[];
+    } | null>;
+    updateDeviceInventory(input: {
+        workspaceId: string;
+        deviceId: string;
+        inventory: WorkspaceDeviceInventory;
+    }): WorkspaceDevice | null | Promise<WorkspaceDevice | null>;
+    setDeviceConnection(input: {
+        workspaceId: string;
+        deviceId: string;
+        instanceId: string;
+        connected: boolean;
+    }): void | Promise<void>;
+    resetDeviceConnections(): void | Promise<void>;
+    removeDevice(input: {
+        workspaceId: string;
+        deviceId: string;
+    }): {
+        reset: boolean;
+        revokedTokenIds: string[];
+    };
+    listRepositories(workspaceId: string): WorkspaceRepository[];
+    listRepositoryCandidates(workspaceId: string): WorkspaceRepositoryCandidate[];
+    listRepositoryPathRequests(workspaceId: string): WorkspaceRepositoryPathRequest[];
+    requestRepositoryPath(input: {
+        workspaceId: string;
+        deviceId: string;
+        path: string;
+        requestedBy?: WorkspaceAuthUser;
+    }): WorkspaceRepositoryPathRequest | null;
+    registerRepository(input: {
+        workspaceId: string;
+        gitUrl: string;
+        name?: string;
+        defaultBranch?: string;
+        createdBy?: WorkspaceAuthUser;
+    }): WorkspaceRepository;
+    registerRepositoryFromCandidate(input: {
+        workspaceId: string;
+        deviceId: string;
+        path: string;
+        createdBy?: WorkspaceAuthUser;
+    }): WorkspaceRepository | null;
+    removeRepository(input: {
+        workspaceId: string;
+        repositoryId: string;
+    }): boolean;
+    listAgents(workspaceId: string): WorkspaceAgent[];
+    createAgent(input: WorkspaceCreateAgentInput): WorkspaceAgentMutationResult;
+    getAgent(input: {
+        workspaceId: string;
+        agentId: string;
+    }): WorkspaceAgent | null;
+    listAgentRevisions(input: {
+        workspaceId: string;
+        agentId: string;
+    }): WorkspaceAgentRevision[];
+    getAgentRevision(input: {
+        workspaceId: string;
+        agentId: string;
+        revisionId: string;
+    }): WorkspaceAgentRevision | null;
+    updateAgent(input: WorkspaceUpdateAgentInput): WorkspaceAgentMutationResult;
+    archiveAgent(input: WorkspaceArchiveAgentInput): WorkspaceAgentMutationResult;
+    createAgentRun(input: WorkspaceCreateAgentRunInput): Promise<WorkspaceCreateAgentRunResult> | WorkspaceCreateAgentRunResult;
+    appendAgentRunTurn(input: WorkspaceAppendAgentRunTurnInput): Promise<WorkspaceAppendAgentRunTurnResult> | WorkspaceAppendAgentRunTurnResult;
+    listAgentRuns(input: {
+        workspaceId: string;
+        agentId?: string;
+        originType?: WorkspaceAgentRunOrigin["type"];
+        status?: WorkspaceAgentRunStatus;
+        limit?: number;
+    }): Promise<WorkspaceAgentRun[]> | WorkspaceAgentRun[];
+    getAgentRunDetail(input: {
+        workspaceId: string;
+        runId: string;
+    }): Promise<WorkspaceAgentRunDetail | null> | WorkspaceAgentRunDetail | null;
+    getAgentRunTurnPage(input: {
+        workspaceId: string;
+        runId: string;
+        beforeSequence: number;
+        limit?: number;
+    }): Promise<WorkspaceAgentRunTurnPage | null> | WorkspaceAgentRunTurnPage | null;
+    agentRunExists(input: {
+        workspaceId: string;
+        runId: string;
+    }): Promise<boolean> | boolean;
+    listAgentRunEvents(input: {
+        workspaceId: string;
+        runId: string;
+        afterSequence?: number;
+        limit?: number;
+    }): Promise<WorkspaceAgentRunEvent[]> | WorkspaceAgentRunEvent[];
+    cancelAgentRun(input: {
+        workspaceId: string;
+        runId: string;
+        requestId: string;
+    }): Promise<{
+        status: "cancelled" | "replayed";
+        run: WorkspaceAgentRunDetail;
+    } | {
+        status: "needs_scheduler";
+        run: WorkspaceAgentRunDetail;
+    } | {
+        status: "not_found";
+    } | {
+        status: "conflict";
+        error: string;
+    }> | ({
+        status: "cancelled" | "replayed";
+        run: WorkspaceAgentRunDetail;
+    } | {
+        status: "needs_scheduler";
+        run: WorkspaceAgentRunDetail;
+    } | {
+        status: "not_found";
+    } | {
+        status: "conflict";
+        error: string;
+    });
+    resolveBlockedAgentRun(input: WorkspaceResolveBlockedAgentRunInput): Promise<WorkspaceResolveBlockedAgentRunResult> | WorkspaceResolveBlockedAgentRunResult;
+    resolveAgentInteraction(input: WorkspaceResolveAgentInteractionInput): Promise<WorkspaceResolveAgentInteractionResult> | WorkspaceResolveAgentInteractionResult;
+    leaseDeviceTasks(input: {
+        workspaceId: string;
+        deviceId: string;
+        leaseOwner: string;
+        limit: number;
+        leaseMs: number;
+    }): Promise<WorkspaceLeasedDeviceTask[]> | WorkspaceLeasedDeviceTask[];
+    listAcceptedDeviceLeases(input: {
+        workspaceId: string;
+        deviceId: string;
+        leaseOwner: string;
+    }): Promise<WorkspaceLeasedDeviceTask[]> | WorkspaceLeasedDeviceTask[];
+    renewDeviceTask(input: {
+        workspaceId: string;
+        deviceId: string;
+        taskId: string;
+        leaseToken: string;
+        leaseOwner: string;
+        leaseMs: number;
+    }): Promise<string | null> | string | null;
+    finishDeviceTask(input: {
+        workspaceId: string;
+        deviceId: string;
+        result: WorkspaceDeviceTaskResult;
+    }): Promise<WorkspaceTaskFinishDisposition> | WorkspaceTaskFinishDisposition;
+    releaseDeviceTask(input: {
+        workspaceId: string;
+        deviceId: string;
+        taskId: string;
+        leaseToken: string;
+    }): Promise<boolean> | boolean;
+    releaseDeviceLeases(input: {
+        workspaceId: string;
+        deviceId: string;
+        exceptOwner: string;
+    }): Promise<number> | number;
+    listSkills(workspaceId: string): Promise<WorkspaceSkillSummary[]> | WorkspaceSkillSummary[];
+    createSkill(input: WorkspaceCreateSkillInput): Promise<WorkspaceSkillMutationResult> | WorkspaceSkillMutationResult;
+    getSkillDetail(input: {
+        workspaceId: string;
+        skillId: string;
+    }): Promise<WorkspaceSkillDetail | null> | WorkspaceSkillDetail | null;
+    listSkillRevisions(input: {
+        workspaceId: string;
+        skillId: string;
+    }): Promise<WorkspaceSkillRevision[]> | WorkspaceSkillRevision[];
+    getSkillRevision(input: {
+        workspaceId: string;
+        skillId: string;
+        revisionId: string;
+    }): Promise<WorkspaceSkillRevisionDetail | null> | WorkspaceSkillRevisionDetail | null;
+    readSkillRevisionFile(input: {
+        workspaceId: string;
+        skillId: string;
+        revisionId: string;
+        path: string;
+    }): Promise<WorkspaceSkillRevisionFile | null> | WorkspaceSkillRevisionFile | null;
+    updateSkill(input: WorkspaceUpdateSkillInput): Promise<WorkspaceSkillMutationResult> | WorkspaceSkillMutationResult;
+    archiveSkill(input: WorkspaceArchiveSkillInput): Promise<WorkspaceSkillMutationResult> | WorkspaceSkillMutationResult;
+    createSkillRuntimeScan(input: {
+        workspaceId: string;
+        deviceId: string;
+        runtimeId: string;
+        createdBy?: WorkspaceAuthUser;
+    }): Promise<WorkspaceSkillRuntimeScanRequest | null> | WorkspaceSkillRuntimeScanRequest | null;
+    getLatestSkillRuntimeScan(input: {
+        workspaceId: string;
+        deviceId: string;
+        runtimeId: string;
+    }): Promise<WorkspaceSkillRuntimeScanRequest | null> | WorkspaceSkillRuntimeScanRequest | null;
+    getSkillRuntimeScan(input: {
+        workspaceId: string;
+        requestId: string;
+    }): Promise<WorkspaceSkillRuntimeScanRequest | null> | WorkspaceSkillRuntimeScanRequest | null;
+    createSkillRuntimeImport(input: {
+        workspaceId: string;
+        deviceId: string;
+        runtimeId: string;
+        keys: string[];
+        createdBy?: WorkspaceAuthUser;
+    }): Promise<WorkspaceSkillRuntimeImportRequest | null> | WorkspaceSkillRuntimeImportRequest | null;
+    getSkillRuntimeImport(input: {
+        workspaceId: string;
+        requestId: string;
+    }): Promise<WorkspaceSkillRuntimeImportRequest | null> | WorkspaceSkillRuntimeImportRequest | null;
+    getSkillArtifact(input: {
+        workspaceId: string;
+        skillRevisionId: string;
+    }): Promise<WorkspaceSkillArtifact | null> | WorkspaceSkillArtifact | null;
+    importSkillsFromUrl(input: {
+        workspaceId: string;
+        url: string;
+        sourceType?: WorkspaceSkillSourceType;
+        createdBy?: WorkspaceAuthUser;
+    }): Promise<WorkspaceSkillImportResult[]> | WorkspaceSkillImportResult[];
+    importSkillsFromArchive(input: {
+        workspaceId: string;
+        filename: string;
+        contentBase64: string;
+        createdBy?: WorkspaceAuthUser;
+    }): Promise<WorkspaceSkillImportResult[]> | WorkspaceSkillImportResult[];
+}