@kya-os/contracts 1.7.32 → 1.7.33

package/dist/gateway/index.d.ts

@@ -1,579 +1,21 @@
 /**
- * OpenClaw Gateway RPC Response Types
+ * OpenClaw Gateway WebSocket RPC Response Types
  *
- * Zod schemas and inferred types for responses from OpenClaw gateway
- * WebSocket methods (skills.status, sessions.list, cron.list, agents.list,
- * usage.cost).
+ * Shared schemas for OpenClaw gateway WS method responses.
+ * Used by both @kya-os/compute (agent-side) and Checkpoint (dashboard-side).
  *
- * Source of truth for both xmcp-i compute and AgentShield dashboard.
+ * Source of truth for gateway WS integration types.
+ * When adding a new gateway method integration:
+ * 1. Add Zod schema + TypeScript type here
+ * 2. Bump @kya-os/contracts version
+ * 3. Vendor into checkpoint, add handler in openclaw-handler.ts
+ * 4. Surface in the relevant dashboard component
  *
- * @module contracts/gateway
+ * @package @kya-os/contracts/gateway
  */
-import { z } from "zod";
-export declare const skillRequirementsSchema: z.ZodObject<{
-    bins: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    envs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    configs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    os: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-}, "strip", z.ZodTypeAny, {
-    bins?: string[] | undefined;
-    envs?: string[] | undefined;
-    configs?: string[] | undefined;
-    os?: string[] | undefined;
-}, {
-    bins?: string[] | undefined;
-    envs?: string[] | undefined;
-    configs?: string[] | undefined;
-    os?: string[] | undefined;
-}>;
-export type SkillRequirements = z.infer<typeof skillRequirementsSchema>;
-export declare const skillConfigCheckSchema: z.ZodObject<{
-    path: z.ZodString;
-    label: z.ZodOptional<z.ZodString>;
-    satisfied: z.ZodBoolean;
-}, "strip", z.ZodTypeAny, {
-    path: string;
-    satisfied: boolean;
-    label?: string | undefined;
-}, {
-    path: string;
-    satisfied: boolean;
-    label?: string | undefined;
-}>;
-export type SkillConfigCheck = z.infer<typeof skillConfigCheckSchema>;
-export declare const skillInstallOptionSchema: z.ZodObject<{
-    id: z.ZodString;
-    kind: z.ZodEnum<["brew", "node", "go", "uv", "download"]>;
-    label: z.ZodString;
-    bins: z.ZodArray<z.ZodString, "many">;
-}, "strip", z.ZodTypeAny, {
-    bins: string[];
-    label: string;
-    id: string;
-    kind: "brew" | "node" | "go" | "uv" | "download";
-}, {
-    bins: string[];
-    label: string;
-    id: string;
-    kind: "brew" | "node" | "go" | "uv" | "download";
-}>;
-export type SkillInstallOption = z.infer<typeof skillInstallOptionSchema>;
-export declare const skillStatusEntrySchema: z.ZodObject<{
-    name: z.ZodString;
-    description: z.ZodString;
-    source: z.ZodString;
-    bundled: z.ZodBoolean;
-    filePath: z.ZodString;
-    baseDir: z.ZodString;
-    skillKey: z.ZodString;
-    primaryEnv: z.ZodOptional<z.ZodString>;
-    emoji: z.ZodOptional<z.ZodString>;
-    homepage: z.ZodOptional<z.ZodString>;
-    always: z.ZodBoolean;
-    disabled: z.ZodBoolean;
-    blockedByAllowlist: z.ZodBoolean;
-    eligible: z.ZodBoolean;
-    requirements: z.ZodObject<{
-        bins: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        envs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        configs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        os: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        bins?: string[] | undefined;
-        envs?: string[] | undefined;
-        configs?: string[] | undefined;
-        os?: string[] | undefined;
-    }, {
-        bins?: string[] | undefined;
-        envs?: string[] | undefined;
-        configs?: string[] | undefined;
-        os?: string[] | undefined;
-    }>;
-    missing: z.ZodObject<{
-        bins: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        envs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        configs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        os: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        bins?: string[] | undefined;
-        envs?: string[] | undefined;
-        configs?: string[] | undefined;
-        os?: string[] | undefined;
-    }, {
-        bins?: string[] | undefined;
-        envs?: string[] | undefined;
-        configs?: string[] | undefined;
-        os?: string[] | undefined;
-    }>;
-    configChecks: z.ZodArray<z.ZodObject<{
-        path: z.ZodString;
-        label: z.ZodOptional<z.ZodString>;
-        satisfied: z.ZodBoolean;
-    }, "strip", z.ZodTypeAny, {
-        path: string;
-        satisfied: boolean;
-        label?: string | undefined;
-    }, {
-        path: string;
-        satisfied: boolean;
-        label?: string | undefined;
-    }>, "many">;
-    install: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        kind: z.ZodEnum<["brew", "node", "go", "uv", "download"]>;
-        label: z.ZodString;
-        bins: z.ZodArray<z.ZodString, "many">;
-    }, "strip", z.ZodTypeAny, {
-        bins: string[];
-        label: string;
-        id: string;
-        kind: "brew" | "node" | "go" | "uv" | "download";
-    }, {
-        bins: string[];
-        label: string;
-        id: string;
-        kind: "brew" | "node" | "go" | "uv" | "download";
-    }>, "many">;
-}, "strip", z.ZodTypeAny, {
-    disabled: boolean;
-    name: string;
-    description: string;
-    source: string;
-    bundled: boolean;
-    filePath: string;
-    baseDir: string;
-    skillKey: string;
-    always: boolean;
-    blockedByAllowlist: boolean;
-    eligible: boolean;
-    requirements: {
-        bins?: string[] | undefined;
-        envs?: string[] | undefined;
-        configs?: string[] | undefined;
-        os?: string[] | undefined;
-    };
-    missing: {
-        bins?: string[] | undefined;
-        envs?: string[] | undefined;
-        configs?: string[] | undefined;
-        os?: string[] | undefined;
-    };
-    configChecks: {
-        path: string;
-        satisfied: boolean;
-        label?: string | undefined;
-    }[];
-    install: {
-        bins: string[];
-        label: string;
-        id: string;
-        kind: "brew" | "node" | "go" | "uv" | "download";
-    }[];
-    primaryEnv?: string | undefined;
-    emoji?: string | undefined;
-    homepage?: string | undefined;
-}, {
-    disabled: boolean;
-    name: string;
-    description: string;
-    source: string;
-    bundled: boolean;
-    filePath: string;
-    baseDir: string;
-    skillKey: string;
-    always: boolean;
-    blockedByAllowlist: boolean;
-    eligible: boolean;
-    requirements: {
-        bins?: string[] | undefined;
-        envs?: string[] | undefined;
-        configs?: string[] | undefined;
-        os?: string[] | undefined;
-    };
-    missing: {
-        bins?: string[] | undefined;
-        envs?: string[] | undefined;
-        configs?: string[] | undefined;
-        os?: string[] | undefined;
-    };
-    configChecks: {
-        path: string;
-        satisfied: boolean;
-        label?: string | undefined;
-    }[];
-    install: {
-        bins: string[];
-        label: string;
-        id: string;
-        kind: "brew" | "node" | "go" | "uv" | "download";
-    }[];
-    primaryEnv?: string | undefined;
-    emoji?: string | undefined;
-    homepage?: string | undefined;
-}>;
-export type SkillStatusEntry = z.infer<typeof skillStatusEntrySchema>;
-export declare const skillStatusReportSchema: z.ZodObject<{
-    workspaceDir: z.ZodString;
-    managedSkillsDir: z.ZodString;
-    skills: z.ZodArray<z.ZodObject<{
-        name: z.ZodString;
-        description: z.ZodString;
-        source: z.ZodString;
-        bundled: z.ZodBoolean;
-        filePath: z.ZodString;
-        baseDir: z.ZodString;
-        skillKey: z.ZodString;
-        primaryEnv: z.ZodOptional<z.ZodString>;
-        emoji: z.ZodOptional<z.ZodString>;
-        homepage: z.ZodOptional<z.ZodString>;
-        always: z.ZodBoolean;
-        disabled: z.ZodBoolean;
-        blockedByAllowlist: z.ZodBoolean;
-        eligible: z.ZodBoolean;
-        requirements: z.ZodObject<{
-            bins: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            envs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            configs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            os: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, "strip", z.ZodTypeAny, {
-            bins?: string[] | undefined;
-            envs?: string[] | undefined;
-            configs?: string[] | undefined;
-            os?: string[] | undefined;
-        }, {
-            bins?: string[] | undefined;
-            envs?: string[] | undefined;
-            configs?: string[] | undefined;
-            os?: string[] | undefined;
-        }>;
-        missing: z.ZodObject<{
-            bins: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            envs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            configs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            os: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, "strip", z.ZodTypeAny, {
-            bins?: string[] | undefined;
-            envs?: string[] | undefined;
-            configs?: string[] | undefined;
-            os?: string[] | undefined;
-        }, {
-            bins?: string[] | undefined;
-            envs?: string[] | undefined;
-            configs?: string[] | undefined;
-            os?: string[] | undefined;
-        }>;
-        configChecks: z.ZodArray<z.ZodObject<{
-            path: z.ZodString;
-            label: z.ZodOptional<z.ZodString>;
-            satisfied: z.ZodBoolean;
-        }, "strip", z.ZodTypeAny, {
-            path: string;
-            satisfied: boolean;
-            label?: string | undefined;
-        }, {
-            path: string;
-            satisfied: boolean;
-            label?: string | undefined;
-        }>, "many">;
-        install: z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            kind: z.ZodEnum<["brew", "node", "go", "uv", "download"]>;
-            label: z.ZodString;
-            bins: z.ZodArray<z.ZodString, "many">;
-        }, "strip", z.ZodTypeAny, {
-            bins: string[];
-            label: string;
-            id: string;
-            kind: "brew" | "node" | "go" | "uv" | "download";
-        }, {
-            bins: string[];
-            label: string;
-            id: string;
-            kind: "brew" | "node" | "go" | "uv" | "download";
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        disabled: boolean;
-        name: string;
-        description: string;
-        source: string;
-        bundled: boolean;
-        filePath: string;
-        baseDir: string;
-        skillKey: string;
-        always: boolean;
-        blockedByAllowlist: boolean;
-        eligible: boolean;
-        requirements: {
-            bins?: string[] | undefined;
-            envs?: string[] | undefined;
-            configs?: string[] | undefined;
-            os?: string[] | undefined;
-        };
-        missing: {
-            bins?: string[] | undefined;
-            envs?: string[] | undefined;
-            configs?: string[] | undefined;
-            os?: string[] | undefined;
-        };
-        configChecks: {
-            path: string;
-            satisfied: boolean;
-            label?: string | undefined;
-        }[];
-        install: {
-            bins: string[];
-            label: string;
-            id: string;
-            kind: "brew" | "node" | "go" | "uv" | "download";
-        }[];
-        primaryEnv?: string | undefined;
-        emoji?: string | undefined;
-        homepage?: string | undefined;
-    }, {
-        disabled: boolean;
-        name: string;
-        description: string;
-        source: string;
-        bundled: boolean;
-        filePath: string;
-        baseDir: string;
-        skillKey: string;
-        always: boolean;
-        blockedByAllowlist: boolean;
-        eligible: boolean;
-        requirements: {
-            bins?: string[] | undefined;
-            envs?: string[] | undefined;
-            configs?: string[] | undefined;
-            os?: string[] | undefined;
-        };
-        missing: {
-            bins?: string[] | undefined;
-            envs?: string[] | undefined;
-            configs?: string[] | undefined;
-            os?: string[] | undefined;
-        };
-        configChecks: {
-            path: string;
-            satisfied: boolean;
-            label?: string | undefined;
-        }[];
-        install: {
-            bins: string[];
-            label: string;
-            id: string;
-            kind: "brew" | "node" | "go" | "uv" | "download";
-        }[];
-        primaryEnv?: string | undefined;
-        emoji?: string | undefined;
-        homepage?: string | undefined;
-    }>, "many">;
-}, "strip", z.ZodTypeAny, {
-    workspaceDir: string;
-    managedSkillsDir: string;
-    skills: {
-        disabled: boolean;
-        name: string;
-        description: string;
-        source: string;
-        bundled: boolean;
-        filePath: string;
-        baseDir: string;
-        skillKey: string;
-        always: boolean;
-        blockedByAllowlist: boolean;
-        eligible: boolean;
-        requirements: {
-            bins?: string[] | undefined;
-            envs?: string[] | undefined;
-            configs?: string[] | undefined;
-            os?: string[] | undefined;
-        };
-        missing: {
-            bins?: string[] | undefined;
-            envs?: string[] | undefined;
-            configs?: string[] | undefined;
-            os?: string[] | undefined;
-        };
-        configChecks: {
-            path: string;
-            satisfied: boolean;
-            label?: string | undefined;
-        }[];
-        install: {
-            bins: string[];
-            label: string;
-            id: string;
-            kind: "brew" | "node" | "go" | "uv" | "download";
-        }[];
-        primaryEnv?: string | undefined;
-        emoji?: string | undefined;
-        homepage?: string | undefined;
-    }[];
-}, {
-    workspaceDir: string;
-    managedSkillsDir: string;
-    skills: {
-        disabled: boolean;
-        name: string;
-        description: string;
-        source: string;
-        bundled: boolean;
-        filePath: string;
-        baseDir: string;
-        skillKey: string;
-        always: boolean;
-        blockedByAllowlist: boolean;
-        eligible: boolean;
-        requirements: {
-            bins?: string[] | undefined;
-            envs?: string[] | undefined;
-            configs?: string[] | undefined;
-            os?: string[] | undefined;
-        };
-        missing: {
-            bins?: string[] | undefined;
-            envs?: string[] | undefined;
-            configs?: string[] | undefined;
-            os?: string[] | undefined;
-        };
-        configChecks: {
-            path: string;
-            satisfied: boolean;
-            label?: string | undefined;
-        }[];
-        install: {
-            bins: string[];
-            label: string;
-            id: string;
-            kind: "brew" | "node" | "go" | "uv" | "download";
-        }[];
-        primaryEnv?: string | undefined;
-        emoji?: string | undefined;
-        homepage?: string | undefined;
-    }[];
-}>;
-export type SkillStatusReport = z.infer<typeof skillStatusReportSchema>;
-export declare const sessionEntrySchema: z.ZodObject<{
-    key: z.ZodString;
-    agentId: z.ZodOptional<z.ZodString>;
-    label: z.ZodOptional<z.ZodString>;
-    channel: z.ZodOptional<z.ZodString>;
-    kind: z.ZodOptional<z.ZodString>;
-    createdAt: z.ZodOptional<z.ZodNumber>;
-    updatedAt: z.ZodOptional<z.ZodNumber>;
-    messageCount: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    key: string;
-    label?: string | undefined;
-    kind?: string | undefined;
-    agentId?: string | undefined;
-    channel?: string | undefined;
-    createdAt?: number | undefined;
-    updatedAt?: number | undefined;
-    messageCount?: number | undefined;
-}, {
-    key: string;
-    label?: string | undefined;
-    kind?: string | undefined;
-    agentId?: string | undefined;
-    channel?: string | undefined;
-    createdAt?: number | undefined;
-    updatedAt?: number | undefined;
-    messageCount?: number | undefined;
-}>;
-export type SessionEntry = z.infer<typeof sessionEntrySchema>;
-export declare const cronJobSchema: z.ZodObject<{
-    name: z.ZodString;
-    schedule: z.ZodOptional<z.ZodString>;
-    enabled: z.ZodBoolean;
-    lastRunAt: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
-    nextRunAt: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
-    lastStatus: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-    agentId: z.ZodOptional<z.ZodString>;
-    model: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-    task: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    enabled: boolean;
-    agentId?: string | undefined;
-    schedule?: string | undefined;
-    lastRunAt?: number | null | undefined;
-    nextRunAt?: number | null | undefined;
-    lastStatus?: string | null | undefined;
-    model?: string | null | undefined;
-    task?: string | undefined;
-}, {
-    name: string;
-    enabled: boolean;
-    agentId?: string | undefined;
-    schedule?: string | undefined;
-    lastRunAt?: number | null | undefined;
-    nextRunAt?: number | null | undefined;
-    lastStatus?: string | null | undefined;
-    model?: string | null | undefined;
-    task?: string | undefined;
-}>;
-export type CronJob = z.infer<typeof cronJobSchema>;
-export declare const agentEntrySchema: z.ZodObject<{
-    id: z.ZodString;
-    name: z.ZodOptional<z.ZodString>;
-    model: z.ZodOptional<z.ZodString>;
-    defaultModel: z.ZodOptional<z.ZodString>;
-    persona: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    id: string;
-    name?: string | undefined;
-    model?: string | undefined;
-    defaultModel?: string | undefined;
-    persona?: string | undefined;
-}, {
-    id: string;
-    name?: string | undefined;
-    model?: string | undefined;
-    defaultModel?: string | undefined;
-    persona?: string | undefined;
-}>;
-export type AgentEntry = z.infer<typeof agentEntrySchema>;
-export declare const usageCostSchema: z.ZodObject<{
-    totalCostUsd: z.ZodOptional<z.ZodNumber>;
-    periodStart: z.ZodOptional<z.ZodString>;
-    periodEnd: z.ZodOptional<z.ZodString>;
-    byModel: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        model: z.ZodString;
-        inputTokens: z.ZodNumber;
-        outputTokens: z.ZodNumber;
-        costUsd: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        model: string;
-        inputTokens: number;
-        outputTokens: number;
-        costUsd: number;
-    }, {
-        model: string;
-        inputTokens: number;
-        outputTokens: number;
-        costUsd: number;
-    }>, "many">>;
-}, "strip", z.ZodTypeAny, {
-    totalCostUsd?: number | undefined;
-    periodStart?: string | undefined;
-    periodEnd?: string | undefined;
-    byModel?: {
-        model: string;
-        inputTokens: number;
-        outputTokens: number;
-        costUsd: number;
-    }[] | undefined;
-}, {
-    totalCostUsd?: number | undefined;
-    periodStart?: string | undefined;
-    periodEnd?: string | undefined;
-    byModel?: {
-        model: string;
-        inputTokens: number;
-        outputTokens: number;
-        costUsd: number;
-    }[] | undefined;
-}>;
-export type UsageCost = z.infer<typeof usageCostSchema>;
+export { skillRequirementsSchema, skillConfigCheckSchema, skillInstallOptionSchema, skillStatusEntrySchema, skillStatusReportSchema, type SkillRequirements, type SkillConfigCheck, type SkillInstallOption, type SkillStatusEntry, type SkillStatusReport, } from "./skills.js";
+export { sessionEntrySchema, type SessionEntry, } from "./sessions.js";
+export { cronJobSchema, type CronJob, } from "./cron.js";
+export { agentEntrySchema, type AgentEntry, } from "./agents.js";
+export { usageCostSchema, type UsageCost, } from "./usage.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/gateway/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gateway/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAEL,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,kBAAkB,EAClB,KAAK,YAAY,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAEL,aAAa,EACb,KAAK,OAAO,GACb,MAAM,WAAW,CAAC;AAEnB,OAAO,EAEL,gBAAgB,EAChB,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,eAAe,EACf,KAAK,SAAS,GACf,MAAM,YAAY,CAAC"}