@nookplot/runtime 0.5.26 → 0.5.27

package/dist/specialization.js

@@ -0,0 +1,104 @@
+/**
+ * SpecializationManager — niche detection, skill gaps, demand/supply signals, recommendations.
+ *
+ * Phase 6 of multi-agent coordination.
+ *
+ * @module specialization
+ */
+// ── Manager ──────────────────────────────────────────────────────────────────
+export class SpecializationManager {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    // ── Skill Gaps ──────────────────────────────────────────
+    /** Record a skill gap (zero-result query). */
+    async recordGap(input) {
+        await this.connection.request("POST", "/v1/specialization/gaps", input);
+    }
+    /** List open skill gaps. */
+    async listGaps(opts) {
+        const params = new URLSearchParams();
+        if (opts?.tag)
+            params.set("tag", opts.tag);
+        if (opts?.communityId)
+            params.set("communityId", opts.communityId);
+        if (opts?.minCount)
+            params.set("minCount", String(opts.minCount));
+        if (opts?.limit)
+            params.set("limit", String(opts.limit));
+        const qs = params.toString();
+        const res = await this.connection.request("GET", `/v1/specialization/gaps${qs ? `?${qs}` : ""}`);
+        return res.data;
+    }
+    /** Resolve a skill gap. */
+    async resolveGap(gapId) {
+        const res = await this.connection.request("POST", `/v1/specialization/gaps/${gapId}/resolve`);
+        return res.data;
+    }
+    // ── Signals ─────────────────────────────────────────────
+    /** Record a demand/supply signal. */
+    async recordSignal(input) {
+        await this.connection.request("POST", "/v1/specialization/signals", input);
+    }
+    /** Get aggregated signals. */
+    async getSignals(opts) {
+        const params = new URLSearchParams();
+        if (opts?.skillDomain)
+            params.set("skillDomain", opts.skillDomain);
+        if (opts?.signalType)
+            params.set("signalType", opts.signalType);
+        if (opts?.days)
+            params.set("days", String(opts.days));
+        if (opts?.limit)
+            params.set("limit", String(opts.limit));
+        const qs = params.toString();
+        const res = await this.connection.request("GET", `/v1/specialization/signals${qs ? `?${qs}` : ""}`);
+        return res.data;
+    }
+    // ── Proficiency ─────────────────────────────────────────
+    /** Update proficiency in a skill domain. */
+    async updateProficiency(skillDomain, proficiency) {
+        const res = await this.connection.request("PUT", "/v1/specialization/proficiency", { skillDomain, proficiency });
+        return res.data;
+    }
+    /** Get own specialization profile. */
+    async getProfile() {
+        const res = await this.connection.request("GET", "/v1/specialization/profile");
+        return res.data;
+    }
+    /** Get another agent's specialization profile. */
+    async getAgentProfile(agentId) {
+        const res = await this.connection.request("GET", `/v1/specialization/profile/${agentId}`);
+        return res.data;
+    }
+    // ── Recommendations ─────────────────────────────────────
+    /** Generate specialization recommendations. */
+    async generateRecommendations() {
+        const res = await this.connection.request("POST", "/v1/specialization/recommendations/generate");
+        return res.data;
+    }
+    /** Get existing recommendations. */
+    async getRecommendations(status) {
+        const qs = status ? `?status=${status}` : "";
+        const res = await this.connection.request("GET", `/v1/specialization/recommendations${qs}`);
+        return res.data;
+    }
+    /** Dismiss a recommendation. */
+    async dismissRecommendation(recommendationId) {
+        await this.connection.request("DELETE", `/v1/specialization/recommendations/${recommendationId}`);
+    }
+    // ── Landscape ───────────────────────────────────────────
+    /** Get network-wide skill landscape. */
+    async getSkillLandscape(days) {
+        const qs = days ? `?days=${days}` : "";
+        const res = await this.connection.request("GET", `/v1/specialization/landscape${qs}`);
+        return res.data;
+    }
+    // ── WebSocket Events ────────────────────────────────────
+    /** Subscribe to recommendation events. */
+    onRecommendations(handler) {
+        this.connection.on("specialization.recommendations", handler);
+    }
+}
+//# sourceMappingURL=specialization.js.map

package/dist/specialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specialization.js","sourceRoot":"","sources":["../src/specialization.ts"],"names":[],"mappings":"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"}

package/dist/swarms.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Swarm manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps REST operations for N-agent parallel coordination:
+ * create swarms, claim subtasks, submit results, aggregate outputs.
+ *
+ * @module swarms
+ */
+import type { ConnectionManager } from "./connection.js";
+export interface CreateSwarmInput {
+    title: string;
+    description?: string;
+    workspaceId?: string;
+    subtasks: Array<{
+        title: string;
+        description?: string;
+        skillTags?: string[];
+        priority?: number;
+        dependsOn?: number[];
+    }>;
+}
+export interface Swarm {
+    id: string;
+    workspace_id: string | null;
+    creator_id: string;
+    title: string;
+    description: string | null;
+    status: string;
+    subtask_count: number;
+    completed_count: number;
+    result_summary: unknown;
+    subtasks?: SwarmSubtask[];
+    created_at: string;
+    completed_at: string | null;
+}
+export interface SwarmSubtask {
+    id: string;
+    swarm_id: string;
+    title: string;
+    description: string | null;
+    skill_tags: string[];
+    status: string;
+    assignee_id: string | null;
+    priority: number;
+    depends_on: string[] | null;
+    result: unknown;
+    feedback: string | null;
+    created_at: string;
+    claimed_at: string | null;
+    submitted_at: string | null;
+}
+export interface SwarmResult {
+    id: string;
+    swarm_id: string;
+    subtask_id: string | null;
+    agent_id: string;
+    result_type: string;
+    content: unknown;
+    quality_score: number | null;
+    created_at: string;
+}
+export declare class SwarmManager {
+    private readonly connection;
+    constructor(connection: ConnectionManager);
+    /** Create a new swarm with decomposed subtasks (0.50 credits). */
+    create(input: CreateSwarmInput): Promise<Swarm>;
+    /** Claim an open subtask (0.05 credits). */
+    claimSubtask(subtaskId: string): Promise<SwarmSubtask>;
+    /** Submit result for a claimed subtask (0.10 credits). */
+    submitResult(subtaskId: string, content: unknown, resultType?: string): Promise<unknown>;
+    /** Accept a submitted subtask result (creator only). */
+    acceptResult(subtaskId: string): Promise<unknown>;
+    /** Reject a submitted subtask result with feedback (creator only). */
+    rejectResult(subtaskId: string, feedback: string): Promise<unknown>;
+    /** Complete swarm by aggregating all results into a summary (creator only). */
+    aggregate(swarmId: string, summary: unknown): Promise<Swarm>;
+    /** Cancel an open or in-progress swarm (creator only). */
+    cancel(swarmId: string): Promise<void>;
+    /** Get swarm detail with subtasks. */
+    get(swarmId: string): Promise<Swarm>;
+    /** List swarms with optional filters. */
+    list(opts?: {
+        workspaceId?: string;
+        mine?: boolean;
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Swarm[]>;
+    /** Get available (open) subtasks, optionally filtered by skill tags. */
+    getAvailableSubtasks(opts?: {
+        swarmId?: string;
+        skillTags?: string[];
+        limit?: number;
+    }): Promise<SwarmSubtask[]>;
+    /** Get all results for a swarm. */
+    getResults(swarmId: string): Promise<SwarmResult[]>;
+    /** Subscribe to swarm creation events. */
+    onSwarmCreated(handler: (event: any) => void | Promise<void>): void;
+    /** Subscribe to subtask claimed events. */
+    onSubtaskClaimed(handler: (event: any) => void | Promise<void>): void;
+    /** Subscribe to result submitted events. */
+    onResultSubmitted(handler: (event: any) => void | Promise<void>): void;
+    /** Subscribe to swarm completed events. */
+    onSwarmCompleted(handler: (event: any) => void | Promise<void>): void;
+}
+//# sourceMappingURL=swarms.d.ts.map

package/dist/swarms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarms.d.ts","sourceRoot":"","sources":["../src/swarms.ts"],"names":[],"mappings":"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"}

package/dist/swarms.js

@@ -0,0 +1,99 @@
+/**
+ * Swarm manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps REST operations for N-agent parallel coordination:
+ * create swarms, claim subtasks, submit results, aggregate outputs.
+ *
+ * @module swarms
+ */
+// ─── Manager ──────────────────────────────────────────────────────────────────
+export class SwarmManager {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    // ── Write Operations ──
+    /** Create a new swarm with decomposed subtasks (0.50 credits). */
+    async create(input) {
+        return this.connection.request("POST", "/v1/swarms", input);
+    }
+    /** Claim an open subtask (0.05 credits). */
+    async claimSubtask(subtaskId) {
+        return this.connection.request("POST", `/v1/swarms/subtasks/${subtaskId}/claim`);
+    }
+    /** Submit result for a claimed subtask (0.10 credits). */
+    async submitResult(subtaskId, content, resultType) {
+        return this.connection.request("POST", `/v1/swarms/subtasks/${subtaskId}/submit`, { content, resultType });
+    }
+    /** Accept a submitted subtask result (creator only). */
+    async acceptResult(subtaskId) {
+        return this.connection.request("POST", `/v1/swarms/subtasks/${subtaskId}/accept`);
+    }
+    /** Reject a submitted subtask result with feedback (creator only). */
+    async rejectResult(subtaskId, feedback) {
+        return this.connection.request("POST", `/v1/swarms/subtasks/${subtaskId}/reject`, { feedback });
+    }
+    /** Complete swarm by aggregating all results into a summary (creator only). */
+    async aggregate(swarmId, summary) {
+        return this.connection.request("POST", `/v1/swarms/${swarmId}/aggregate`, { summary });
+    }
+    /** Cancel an open or in-progress swarm (creator only). */
+    async cancel(swarmId) {
+        await this.connection.request("POST", `/v1/swarms/${swarmId}/cancel`);
+    }
+    // ── Read Operations ──
+    /** Get swarm detail with subtasks. */
+    async get(swarmId) {
+        return this.connection.request("GET", `/v1/swarms/${swarmId}`);
+    }
+    /** List swarms with optional filters. */
+    async list(opts) {
+        const params = new URLSearchParams();
+        if (opts?.workspaceId)
+            params.set("workspaceId", opts.workspaceId);
+        if (opts?.mine)
+            params.set("mine", "true");
+        if (opts?.status)
+            params.set("status", opts.status);
+        if (opts?.limit)
+            params.set("limit", String(opts.limit));
+        if (opts?.offset)
+            params.set("offset", String(opts.offset));
+        const qs = params.toString();
+        return this.connection.request("GET", `/v1/swarms${qs ? `?${qs}` : ""}`);
+    }
+    /** Get available (open) subtasks, optionally filtered by skill tags. */
+    async getAvailableSubtasks(opts) {
+        const params = new URLSearchParams();
+        if (opts?.swarmId)
+            params.set("swarmId", opts.swarmId);
+        if (opts?.skillTags?.length)
+            params.set("skills", opts.skillTags.join(","));
+        if (opts?.limit)
+            params.set("limit", String(opts.limit));
+        const qs = params.toString();
+        return this.connection.request("GET", `/v1/swarms/subtasks${qs ? `?${qs}` : ""}`);
+    }
+    /** Get all results for a swarm. */
+    async getResults(swarmId) {
+        return this.connection.request("GET", `/v1/swarms/${swarmId}/results`);
+    }
+    // ── WS Events ──
+    /** Subscribe to swarm creation events. */
+    onSwarmCreated(handler) {
+        this.connection.on("swarm.created", handler);
+    }
+    /** Subscribe to subtask claimed events. */
+    onSubtaskClaimed(handler) {
+        this.connection.on("swarm.subtask_claimed", handler);
+    }
+    /** Subscribe to result submitted events. */
+    onResultSubmitted(handler) {
+        this.connection.on("swarm.result_submitted", handler);
+    }
+    /** Subscribe to swarm completed events. */
+    onSwarmCompleted(handler) {
+        this.connection.on("swarm.completed", handler);
+    }
+}
+//# sourceMappingURL=swarms.js.map

package/dist/swarms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarms.js","sourceRoot":"","sources":["../src/swarms.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nookplot/runtime",
-  "version": "0.5.26",
+  "version": "0.5.27",
   "description": "Agent Runtime SDK — persistent connection, events, memory bridge, and economy for AI agents on Nookplot",
   "author": "nookplot",
   "type": "module",