@runtypelabs/sdk 3.0.0 → 4.0.1

package/dist/index.mjs

@@ -1668,6 +1668,175 @@ var PromptsNamespace = class {
   }
 };
 
+// src/skills-namespace.ts
+var SkillProposalsNamespace = class {
+  constructor(getClient) {
+    this.getClient = getClient;
+  }
+  /**
+   * List pending skill proposals for the authenticated owner.
+   *
+   * @example
+   * ```typescript
+   * const pending = await Runtype.skills.proposals.list()
+   * ```
+   */
+  async list() {
+    const client = this.getClient();
+    const res = await client.get("/skill-proposals");
+    return res.data;
+  }
+  /**
+   * Approve a pending proposal — publishes the proposed skill version.
+   *
+   * @example
+   * ```typescript
+   * const proposal = await Runtype.skills.proposals.approve('skprop_123')
+   * ```
+   */
+  async approve(proposalId) {
+    const client = this.getClient();
+    const res = await client.post(
+      `/skill-proposals/${proposalId}/approve`
+    );
+    return res.proposal;
+  }
+  /**
+   * Reject a pending proposal with an optional reason.
+   *
+   * @example
+   * ```typescript
+   * await Runtype.skills.proposals.reject('skprop_123', 'Capabilities too broad')
+   * ```
+   */
+  async reject(proposalId, reason) {
+    const client = this.getClient();
+    const res = await client.post(
+      `/skill-proposals/${proposalId}/reject`,
+      reason !== void 0 ? { reason } : {}
+    );
+    return res.proposal;
+  }
+};
+var SkillsNamespace = class {
+  constructor(getClient) {
+    this.getClient = getClient;
+    this.proposals = new SkillProposalsNamespace(getClient);
+  }
+  /**
+   * Create a skill from a SKILL.md string (`markdown`) or a structured manifest
+   * (`frontmatter` + `body`). Pass `publish: true` to publish the first version
+   * immediately; otherwise it lands as a draft.
+   */
+  async create(input) {
+    const client = this.getClient();
+    return client.post("/skills", input);
+  }
+  /**
+   * List skills for the authenticated owner, optionally filtered by status.
+   *
+   * @example
+   * ```typescript
+   * const active = await Runtype.skills.list({ status: 'active' })
+   * ```
+   */
+  async list(params) {
+    const client = this.getClient();
+    const res = await client.get("/skills", params);
+    return res.data;
+  }
+  /**
+   * Get a skill and its full version history.
+   *
+   * @example
+   * ```typescript
+   * const { skill, versions } = await Runtype.skills.get('skill_123')
+   * ```
+   */
+  async get(skillId) {
+    const client = this.getClient();
+    return client.get(`/skills/${skillId}`);
+  }
+  /**
+   * Append a new version to an existing skill from an updated manifest. Pass
+   * `publish: true` to publish the new version immediately.
+   */
+  async update(skillId, input) {
+    const client = this.getClient();
+    const res = await client.put(`/skills/${skillId}`, input);
+    return res.version;
+  }
+  /**
+   * Delete a skill (and its versions + bindings, via cascade).
+   */
+  async delete(skillId) {
+    const client = this.getClient();
+    await client.delete(`/skills/${skillId}`);
+  }
+  /**
+   * List a skill's versions, newest first.
+   */
+  async listVersions(skillId) {
+    const client = this.getClient();
+    const res = await client.get(`/skills/${skillId}/versions`);
+    return res.data;
+  }
+  /**
+   * Publish a specific version of a skill.
+   *
+   * @example
+   * ```typescript
+   * await Runtype.skills.publishVersion('skill_123', 'skillver_456')
+   * ```
+   */
+  async publishVersion(skillId, versionId) {
+    const client = this.getClient();
+    await client.post(`/skills/${skillId}/versions/${versionId}/publish`);
+  }
+  /**
+   * Import a single SKILL.md document. The imported skill lands with
+   * `trustLevel: 'imported'` and a draft version.
+   *
+   * @example
+   * ```typescript
+   * const { skill } = await Runtype.skills.import(skillMarkdown)
+   * ```
+   */
+  async import(markdown) {
+    const client = this.getClient();
+    return client.post("/skills/import", { markdown });
+  }
+  /**
+   * Bind a skill to an agent. Both the agent and the skill must be owned by the
+   * caller.
+   */
+  async bind(input) {
+    const client = this.getClient();
+    const res = await client.post("/skills/bind", input);
+    return res.binding;
+  }
+  /**
+   * Remove a skill binding by its binding id.
+   */
+  async unbind(bindingId) {
+    const client = this.getClient();
+    await client.delete(`/skills/bindings/${bindingId}`);
+  }
+  /**
+   * List an agent's skill bindings.
+   *
+   * @example
+   * ```typescript
+   * const bindings = await Runtype.skills.listBindings('agent_123')
+   * ```
+   */
+  async listBindings(agentId) {
+    const client = this.getClient();
+    const res = await client.get("/skills/bindings", { agentId });
+    return res.data;
+  }
+};
+
 // src/transform.ts
 function transformResponse(data) {
   return data;
@@ -1715,6 +1884,7 @@ var RuntypeClient = class {
   /**
    * Generic GET request
    */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- accepts typed list-param interfaces (no index signature); `unknown` would reject them
   async get(path, params) {
     const url = this.buildUrl(path, params);
     const response = await this.makeRequest(url, {
@@ -1735,6 +1905,29 @@ var RuntypeClient = class {
     });
     return this.transformResponse(response);
   }
+  /**
+   * Generic PUT request
+   */
+  async put(path, data) {
+    const url = this.buildUrl(path);
+    const response = await this.makeRequest(url, {
+      method: "PUT",
+      headers: this.headers,
+      body: data ? JSON.stringify(data) : void 0
+    });
+    return this.transformResponse(response);
+  }
+  /**
+   * Generic DELETE request
+   */
+  async delete(path) {
+    const url = this.buildUrl(path);
+    const response = await this.makeRequest(url, {
+      method: "DELETE",
+      headers: this.headers
+    });
+    return this.transformResponse(response);
+  }
   /**
    * Generic request that returns raw Response for streaming
    */
@@ -1761,6 +1954,7 @@ var RuntypeClient = class {
   /**
    * Build full URL with query parameters
    */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- mirrors get()'s permissive params type
   buildUrl(path, params) {
     const base = this.baseUrl.endsWith("/") ? this.baseUrl : `${this.baseUrl}/`;
     const relPath = path.startsWith("/") ? path.slice(1) : path;
@@ -1986,6 +2180,25 @@ var Runtype = class {
   static get prompts() {
     return new PromptsNamespace(() => this.getClient());
   }
+  /**
+   * Skills namespace - Manage Agent Skills (admin/control plane)
+   *
+   * @example
+   * ```typescript
+   * // Create a published skill from a SKILL.md document
+   * const { skill } = await Runtype.skills.create({ markdown: skillMd, publish: true })
+   *
+   * // Bind it to an agent
+   * await Runtype.skills.bind({ agentId: 'agent_123', skillId: skill.id })
+   *
+   * // Review agent-authored proposals
+   * const pending = await Runtype.skills.proposals.list()
+   * await Runtype.skills.proposals.approve(pending[0].id)
+   * ```
+   */
+  static get skills() {
+    return new SkillsNamespace(() => this.getClient());
+  }
 };
 
 // src/generated-tool-gate.ts
@@ -4178,12 +4391,6 @@ var ToolsEndpoint = class {
   async test(id, data) {
     return this.client.post(`/tools/${id}/test`, data);
   }
-  /**
-   * Get tool executions for a specific tool
-   */
-  async getExecutions(toolId, params) {
-    return this.client.get(`/tools/${toolId}/executions`, params);
-  }
   /**
    * Get AI SDK compatible tool schemas
    */
@@ -9132,6 +9339,8 @@ export {
   STEP_TYPE_TO_METHOD,
   SchedulesEndpoint,
   SecretsEndpoint,
+  SkillProposalsNamespace,
+  SkillsNamespace,
   SurfacesEndpoint,
   ToolsEndpoint,
   UsersEndpoint,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/sdk",
-  "version": "3.0.0",
+  "version": "4.0.1",
   "type": "module",
   "description": "TypeScript SDK for the Runtype API with fluent methods. Use it to quickly realize AI products, agents, and workflows.",
   "main": "dist/index.cjs",