@rkat/sdk 0.3.4 → 0.4.0

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Public domain types for the Meerkat TypeScript SDK.
+ *
+ * These replace the `Wire*` prefixed generated types.  All fields use
+ * idiomatic camelCase.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rkat/sdk",
-  "version": "0.3.4",
+  "version": "0.4.0",
   "description": "TypeScript SDK for Meerkat agent runtime",
   "type": "module",
   "main": "./dist/index.js",

package/dist/capabilities.d.ts

@@ -1,24 +0,0 @@
-/**
- * Capability checking and method gating for the Meerkat SDK.
- */
-import type { CapabilitiesResponse } from "./generated/types.js";
-/**
- * Gates method calls by checking runtime capabilities.
- *
- * @example
- * ```ts
- * const checker = new CapabilityChecker(capabilitiesResponse);
- * checker.require("comms"); // throws if comms not available
- * ```
- */
-export declare class CapabilityChecker {
-    private capabilities;
-    constructor(response: CapabilitiesResponse);
-    /** Check if a capability is available. */
-    has(capabilityId: string): boolean;
-    /** Throw CapabilityUnavailableError if capability is not available. */
-    require(capabilityId: string): void;
-    /** List all available capability IDs. */
-    get available(): string[];
-}
-//# sourceMappingURL=capabilities.d.ts.map

package/dist/capabilities.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAGjE;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,YAAY,CAAsB;gBAE9B,QAAQ,EAAE,oBAAoB;IAM1C,0CAA0C;IAC1C,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAIlC,uEAAuE;IACvE,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IASnC,yCAAyC;IACzC,IAAI,SAAS,IAAI,MAAM,EAAE,CAIxB;CACF"}

package/dist/capabilities.js

@@ -1,36 +0,0 @@
-/**
- * Capability checking and method gating for the Meerkat SDK.
- */
-import { CapabilityUnavailableError } from "./generated/errors.js";
-/**
- * Gates method calls by checking runtime capabilities.
- *
- * @example
- * ```ts
- * const checker = new CapabilityChecker(capabilitiesResponse);
- * checker.require("comms"); // throws if comms not available
- * ```
- */
-export class CapabilityChecker {
-    capabilities;
-    constructor(response) {
-        this.capabilities = new Map(response.capabilities.map((c) => [c.id, c.status]));
-    }
-    /** Check if a capability is available. */
-    has(capabilityId) {
-        return this.capabilities.get(capabilityId) === "Available";
-    }
-    /** Throw CapabilityUnavailableError if capability is not available. */
-    require(capabilityId) {
-        if (!this.has(capabilityId)) {
-            throw new CapabilityUnavailableError("CAPABILITY_UNAVAILABLE", `Capability '${capabilityId}' is not available in this runtime`);
-        }
-    }
-    /** List all available capability IDs. */
-    get available() {
-        return [...this.capabilities.entries()]
-            .filter(([, status]) => status === "Available")
-            .map(([id]) => id);
-    }
-}
-//# sourceMappingURL=capabilities.js.map

package/dist/capabilities.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAEnE;;;;;;;;GAQG;AACH,MAAM,OAAO,iBAAiB;IACpB,YAAY,CAAsB;IAE1C,YAAY,QAA8B;QACxC,IAAI,CAAC,YAAY,GAAG,IAAI,GAAG,CACzB,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CACnD,CAAC;IACJ,CAAC;IAED,0CAA0C;IAC1C,GAAG,CAAC,YAAoB;QACtB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,WAAW,CAAC;IAC7D,CAAC;IAED,uEAAuE;IACvE,OAAO,CAAC,YAAoB;QAC1B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,0BAA0B,CAClC,wBAAwB,EACxB,eAAe,YAAY,oCAAoC,CAChE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,IAAI,SAAS;QACX,OAAO,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;aACpC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,KAAK,WAAW,CAAC;aAC9C,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;CACF"}

package/dist/skills.d.ts

@@ -1,41 +0,0 @@
-/**
- * Skill invocation helpers for the Meerkat SDK.
- */
-import type { MeerkatClient } from "./client.js";
-import type { WireRunResult } from "./generated/types.js";
-/**
- * Helpers for working with Meerkat skills.
- *
- * Skills are loaded by the agent from filesystem and embedded sources.
- * The agent's system prompt contains an inventory of available skills.
- * To invoke a skill, include its reference (e.g. `/shell-patterns`)
- * in the user prompt.
- *
- * @example
- * ```ts
- * const helper = new SkillHelper(client);
- * helper.requireSkills();
- * const result = await helper.invoke(sessionId, "/shell-patterns", "How do I run a background job?");
- * ```
- */
-export declare class SkillHelper {
-    private client;
-    constructor(client: MeerkatClient);
-    /** Check if the skills capability is available in this runtime. */
-    isAvailable(): boolean;
-    /** Throw if skills capability is not available. */
-    requireSkills(): void;
-    /**
-     * Invoke a skill within an existing session.
-     *
-     * The skill reference (e.g. `/shell-patterns`) is prepended to the prompt.
-     * The agent's system prompt already contains the skill inventory, so it
-     * knows how to resolve the reference.
-     */
-    invoke(sessionId: string, skillReference: string, prompt: string): Promise<WireRunResult>;
-    /**
-     * Create a new session and invoke a skill in the first turn.
-     */
-    invokeNewSession(skillReference: string, prompt: string, model?: string): Promise<WireRunResult>;
-}
-//# sourceMappingURL=skills.d.ts.map

package/dist/skills.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,aAAa;IAIjC,mEAAmE;IACnE,WAAW,IAAI,OAAO;IAItB,mDAAmD;IACnD,aAAa,IAAI,IAAI;IAUrB;;;;;;OAMG;IACG,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,CAAC;IAMzB;;OAEG;IACG,gBAAgB,CACpB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,CAAC;CAK1B"}

package/dist/skills.js

@@ -1,57 +0,0 @@
-/**
- * Skill invocation helpers for the Meerkat SDK.
- */
-import { CapabilityUnavailableError } from "./generated/errors.js";
-/**
- * Helpers for working with Meerkat skills.
- *
- * Skills are loaded by the agent from filesystem and embedded sources.
- * The agent's system prompt contains an inventory of available skills.
- * To invoke a skill, include its reference (e.g. `/shell-patterns`)
- * in the user prompt.
- *
- * @example
- * ```ts
- * const helper = new SkillHelper(client);
- * helper.requireSkills();
- * const result = await helper.invoke(sessionId, "/shell-patterns", "How do I run a background job?");
- * ```
- */
-export class SkillHelper {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    /** Check if the skills capability is available in this runtime. */
-    isAvailable() {
-        return this.client.hasCapability("skills");
-    }
-    /** Throw if skills capability is not available. */
-    requireSkills() {
-        if (!this.isAvailable()) {
-            throw new CapabilityUnavailableError("CAPABILITY_UNAVAILABLE", "Skills capability is not available in this runtime. " +
-                "Build with --features skills to enable.");
-        }
-    }
-    /**
-     * Invoke a skill within an existing session.
-     *
-     * The skill reference (e.g. `/shell-patterns`) is prepended to the prompt.
-     * The agent's system prompt already contains the skill inventory, so it
-     * knows how to resolve the reference.
-     */
-    async invoke(sessionId, skillReference, prompt) {
-        this.requireSkills();
-        const fullPrompt = `${skillReference} ${prompt}`;
-        return this.client.startTurn(sessionId, fullPrompt);
-    }
-    /**
-     * Create a new session and invoke a skill in the first turn.
-     */
-    async invokeNewSession(skillReference, prompt, model) {
-        this.requireSkills();
-        const fullPrompt = `${skillReference} ${prompt}`;
-        return this.client.createSession({ prompt: fullPrompt, model });
-    }
-}
-//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"skills.js","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAEnE;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,WAAW;IACd,MAAM,CAAgB;IAE9B,YAAY,MAAqB;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,mEAAmE;IACnE,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED,mDAAmD;IACnD,aAAa;QACX,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,IAAI,0BAA0B,CAClC,wBAAwB,EACxB,sDAAsD;gBACpD,yCAAyC,CAC5C,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CACV,SAAiB,EACjB,cAAsB,EACtB,MAAc;QAEd,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,MAAM,UAAU,GAAG,GAAG,cAAc,IAAI,MAAM,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CACpB,cAAsB,EACtB,MAAc,EACd,KAAc;QAEd,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,MAAM,UAAU,GAAG,GAAG,cAAc,IAAI,MAAM,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAClE,CAAC;CACF"}