@prismer/sdk 2.0.6 → 2.0.8

package/dist/index.mjs

@@ -3786,6 +3786,37 @@ var WorkspaceClient = class {
 var TasksClient = class {
   constructor(_r) {
     this._r = _r;
+    // ── release201/10 rev 2 — SPEC.md ─────────────────────────────────────
+    this.spec = {
+      /** Read SPEC.md latest revision. */
+      get: (taskId) => this._r("GET", `/api/im/tasks/${taskId}/spec`),
+      /** Owner sets/updates SPEC.md (writes a new revision). */
+      set: (taskId, input) => this._r("PUT", `/api/im/tasks/${taskId}/spec`, input)
+    };
+    // ── release201/10 rev 2 — TODO.md ─────────────────────────────────────
+    this.todo = {
+      list: (taskId) => this._r("GET", `/api/im/tasks/${taskId}/todo`),
+      add: (taskId, input) => this._r("POST", `/api/im/tasks/${taskId}/todo/items`, input),
+      toggle: (taskId, index, done) => this._r("PATCH", `/api/im/tasks/${taskId}/todo/items/${index}`, { done }),
+      setText: (taskId, index, text) => this._r("PATCH", `/api/im/tasks/${taskId}/todo/items/${index}`, { text }),
+      remove: (taskId, index) => this._r("DELETE", `/api/im/tasks/${taskId}/todo/items/${index}`)
+    };
+    this.criteria = {
+      /** List current criteria via the acceptance view. */
+      list: (taskId) => this._r("GET", `/api/im/tasks/${taskId}/acceptance`),
+      /** Add a criterion (rev 2 — verifyMode + expectation + verifierAgentId). */
+      add: (taskId, input) => this._r("POST", `/api/im/tasks/${taskId}/criteria`, input),
+      /** Update a criterion in place. */
+      update: (taskId, cid, patch) => this._r("PATCH", `/api/im/tasks/${taskId}/criteria/${cid}`, patch),
+      /** Remove a criterion. */
+      remove: (taskId, cid) => this._r("DELETE", `/api/im/tasks/${taskId}/criteria/${cid}`),
+      /**
+       * Unified verify entry (rev 2). Manual reviewer, agent-self-check
+       * report, AND verifier-agent report all use this — cloud routes by
+       * actor identity.
+       */
+      verify: (taskId, cid, input) => this._r("POST", `/api/im/tasks/${taskId}/criteria/${cid}/verify`, input)
+    };
   }
   /** Create a new task */
   async create(options) {
@@ -3805,6 +3836,7 @@ var TasksClient = class {
     if (options?.limit != null) query.limit = String(options.limit);
     if (options?.cursor) query.cursor = options.cursor;
     if (options?.workspaceId) query.workspaceId = options.workspaceId;
+    if (options?.projectId) query.projectId = options.projectId;
     if (options?.conversationId) query.conversationId = options.conversationId;
     return this._r("GET", "/api/im/tasks", void 0, query);
   }
@@ -3840,6 +3872,10 @@ var TasksClient = class {
   async update(taskId, options) {
     return this._r("PATCH", `/api/im/tasks/${taskId}`, options);
   }
+  /** Move a task into a project, or pass null to return it to workspace-level. */
+  async moveProject(taskId, targetProjectId) {
+    return this._r("POST", `/api/im/tasks/${taskId}/move-project`, { targetProjectId });
+  }
   /** Claim a pending task */
   async claim(taskId) {
     return this._r("POST", `/api/im/tasks/${taskId}/claim`);
@@ -3894,6 +3930,39 @@ var TasksClient = class {
   async forceTransition(taskId, options) {
     return this._r("POST", `/api/im/tasks/${taskId}/force-transition`, options);
   }
+  // ── release201/10 — acceptance criteria ──────────────────────────────
+  /** Get rolled-up acceptance + criteria list for a task. */
+  async getAcceptance(taskId) {
+    return this._r("GET", `/api/im/tasks/${taskId}/acceptance`);
+  }
+  /** Copy a template's criteria onto the task. */
+  async applyTemplate(taskId, templateId) {
+    return this._r("POST", `/api/im/tasks/${taskId}/apply-template`, { templateId });
+  }
+};
+var CriteriaTemplatesClient = class {
+  constructor(_r) {
+    this._r = _r;
+  }
+  list(query) {
+    const q = {};
+    if (query?.capability) q.capability = query.capability;
+    if (query?.workspaceId === null) q.workspaceId = "__global";
+    else if (query?.workspaceId) q.workspaceId = query.workspaceId;
+    return this._r("GET", "/api/im/criteria-templates", void 0, q);
+  }
+  get(id) {
+    return this._r("GET", `/api/im/criteria-templates/${id}`);
+  }
+  create(input) {
+    return this._r("POST", "/api/im/criteria-templates", input);
+  }
+  update(id, patch) {
+    return this._r("PATCH", `/api/im/criteria-templates/${id}`, patch);
+  }
+  delete(id) {
+    return this._r("DELETE", `/api/im/criteria-templates/${id}`);
+  }
 };
 var MemoryClient = class {
   constructor(_r) {
@@ -3966,6 +4035,32 @@ var KnowledgeLinkClient = class {
     return this._r("GET", "/api/im/knowledge/links", void 0, { entityType, entityId });
   }
 };
+var MetricsClient = class {
+  constructor(_r) {
+    this._r = _r;
+  }
+  async emit(input) {
+    return this._r("POST", "/api/im/metrics/emit", input);
+  }
+  async batch(events) {
+    return this._r("POST", "/api/im/metrics/batch", { events });
+  }
+  async aggregate(opts) {
+    const query = {
+      namespace: opts.namespace,
+      name: opts.name,
+      agg: opts.agg
+    };
+    if (opts.range) query.range = opts.range;
+    if (opts.from) query.from = opts.from;
+    if (opts.to) query.to = opts.to;
+    if (opts.groupBy && opts.groupBy.length) query.groupBy = opts.groupBy.join(",");
+    if (opts.bucket) query.bucket = opts.bucket;
+    const filterPairs = Object.entries(opts.filter).map(([k, v]) => `${k}:${v}`);
+    if (filterPairs.length) query.filter = filterPairs.join(",");
+    return this._r("GET", "/api/im/metrics/aggregate", void 0, query);
+  }
+};
 var IdentityClient = class {
   constructor(_r) {
     this._r = _r;
@@ -4130,9 +4225,51 @@ var EvolutionSkillsClient = class {
     return this._r("POST", `/api/im/skills/${encodeURIComponent(skillId)}/star`);
   }
 };
+var AgentSkillsClient = class {
+  constructor(_r) {
+    this._r = _r;
+  }
+  /** List skills installed on the agent. */
+  async list(agentId, options) {
+    const query = {};
+    if (options?.workspaceId) query.workspaceId = options.workspaceId;
+    if (options?.includeInactive) query.includeInactive = "true";
+    return this._r("GET", `/api/im/agents/${encodeURIComponent(agentId)}/skills`, void 0, query);
+  }
+  /** Install a published skill onto the agent. */
+  async install(agentId, input) {
+    return this._r("POST", `/api/im/agents/${encodeURIComponent(agentId)}/skills`, input);
+  }
+  /** Uninstall (or disable, for built-ins) a skill from the agent. */
+  async uninstall(agentId, skillIdOrSlug, options) {
+    const query = {};
+    if (options?.workspaceId) query.workspaceId = options.workspaceId;
+    return this._r(
+      "DELETE",
+      `/api/im/agents/${encodeURIComponent(agentId)}/skills/${encodeURIComponent(skillIdOrSlug)}`,
+      void 0,
+      query
+    );
+  }
+  /**
+   * PATCH /api/im/agents/:agentId/skills/:skillId — Update per-skill config.
+   *
+   * Validates against the skill's `executableJson.configSchema` server-side
+   * (release201/13 §3.4 / 07 §2.6). Returns the updated agentSkill row;
+   * `installedRevision` will be null until the next daemon sync poll.
+   */
+  async updateConfig(agentId, skillId, config, options) {
+    return this._r(
+      "PATCH",
+      `/api/im/agents/${encodeURIComponent(agentId)}/skills/${encodeURIComponent(skillId)}`,
+      { config, workspaceId: options?.workspaceId }
+    );
+  }
+};
 var AgentsClient = class {
   constructor(_r) {
     this._r = _r;
+    this.skills = new AgentSkillsClient(_r);
   }
   async spec(agentId, workspaceId) {
     const query = workspaceId ? { workspaceId } : void 0;
@@ -4169,6 +4306,63 @@ var AgentsClient = class {
   async deletePack(packIdOrSlug) {
     return this._r("DELETE", `/api/im/agent-packs/${encodeURIComponent(packIdOrSlug)}`);
   }
+  // release201/09 §9.7.2 Phase 3 — agent quiesce + transfer endpoints.
+  //
+  // pause/resume: workspace owner / orchestrator / admin only. Used by
+  // `prismer agent export` to halt cloud dispatch on the source device
+  // before tarballing the agent dir, and by `prismer agent import` to
+  // resume dispatch on the target device after rebind.
+  async pause(agentId) {
+    return this._r("POST", `/api/im/agents/${encodeURIComponent(agentId)}/pause`, {});
+  }
+  async resume(agentId) {
+    return this._r("POST", `/api/im/agents/${encodeURIComponent(agentId)}/resume`, {});
+  }
+  async transfer(input) {
+    return this._r("POST", "/api/im/agent-bindings/transfer", input);
+  }
+};
+var StudioEvolutionClient = class {
+  constructor(_r) {
+    this._r = _r;
+  }
+  /** List capsules emitted by the target agent (workspace-owner-scoped). */
+  async capsules(agentId, options) {
+    const query = { agentId };
+    if (options?.page != null) query.page = String(options.page);
+    if (options?.limit != null) query.limit = String(options.limit);
+    if (options?.scope) query.scope = options.scope;
+    return this._r("GET", "/api/im/studio/evolution/capsules", void 0, query);
+  }
+  /** List genes owned by the target agent (workspace-owner-scoped). */
+  async genes(agentId, options) {
+    const query = { agentId };
+    if (options?.signals) query.signals = options.signals;
+    return this._r("GET", "/api/im/studio/evolution/genes", void 0, query);
+  }
+};
+var StudioClient = class {
+  constructor(_r) {
+    this._r = _r;
+    this.evolution = new StudioEvolutionClient(_r);
+  }
+  /** Studio overview — counts + recent activity for a workspace. */
+  async getOverview(workspaceId) {
+    const query = workspaceId ? { workspaceId } : void 0;
+    return this._r("GET", "/api/im/studio/overview", void 0, query);
+  }
+  /** Studio Profile domain — agent identity / personality / credits. */
+  async getProfile(agentId) {
+    const query = agentId ? { agentId } : void 0;
+    return this._r("GET", "/api/im/studio/profile", void 0, query);
+  }
+  /** Studio Installed domain — workspace agents + active agent's skills. */
+  async getInstalled(options) {
+    const query = {};
+    if (options?.workspaceId) query.workspaceId = options.workspaceId;
+    if (options?.agentId) query.agentId = options.agentId;
+    return this._r("GET", "/api/im/studio/installed", void 0, query);
+  }
 };
 var EvolutionClient = class {
   constructor(_r) {
@@ -4671,6 +4865,8 @@ function safeSlug(input) {
 var WorkspacesClient = class {
   constructor(_r) {
     this._r = _r;
+    this.members = new WorkspaceMembersClient(_r);
+    this.invites = new WorkspaceInvitesClient(_r);
   }
   /** List active workspaces owned by the caller. */
   async list() {
@@ -4726,6 +4922,101 @@ var WorkspacesClient = class {
   async revokeOrchestrator(workspaceId) {
     return this._r("DELETE", `/api/im/workspaces/${workspaceId}/orchestrator`);
   }
+  // Sub-clients `members` / `invites` are declared at the top of the class and
+  // wired up inside the constructor body — see `AgentsClient` for the same
+  // pattern. Declaring them as field initializers that reference `this._r`
+  // hits TS2729 because parameter-property assignment happens after class
+  // field initializers under `useDefineForClassFields`.
+};
+var WorkspaceMembersClient = class {
+  constructor(_r) {
+    this._r = _r;
+  }
+  async list(workspaceId) {
+    return this._r("GET", `/api/im/workspaces/${workspaceId}/members`);
+  }
+  async add(workspaceId, options) {
+    return this._r("POST", `/api/im/workspaces/${workspaceId}/members`, options);
+  }
+  async update(workspaceId, memberId, options) {
+    return this._r("PATCH", `/api/im/workspaces/${workspaceId}/members/${memberId}`, options);
+  }
+  async remove(workspaceId, memberId) {
+    return this._r("DELETE", `/api/im/workspaces/${workspaceId}/members/${memberId}`);
+  }
+};
+var WorkspaceInvitesClient = class {
+  constructor(_r) {
+    this._r = _r;
+  }
+  async create(workspaceId, options) {
+    return this._r("POST", `/api/im/workspaces/${workspaceId}/invites`, options);
+  }
+  async list(workspaceId) {
+    return this._r("GET", `/api/im/workspaces/${workspaceId}/invites`);
+  }
+  async revoke(workspaceId, inviteId) {
+    return this._r("DELETE", `/api/im/workspaces/${workspaceId}/invites/${inviteId}`);
+  }
+};
+var InvitesClient = class {
+  constructor(_r) {
+    this._r = _r;
+  }
+  async preview(token) {
+    return this._r("GET", `/api/im/invites/${encodeURIComponent(token)}`);
+  }
+  async accept(token) {
+    return this._r("POST", `/api/im/invites/${encodeURIComponent(token)}/accept`);
+  }
+  async reject(token) {
+    return this._r("POST", `/api/im/invites/${encodeURIComponent(token)}/reject`);
+  }
+};
+var ProjectMembersClient = class {
+  constructor(_r) {
+    this._r = _r;
+  }
+  async list(projectId) {
+    return this._r("GET", `/api/im/projects/${projectId}/members`);
+  }
+  async add(projectId, options) {
+    return this._r("POST", `/api/im/projects/${projectId}/members`, options);
+  }
+  async update(projectId, membershipId, options) {
+    return this._r("PATCH", `/api/im/projects/${projectId}/members/${membershipId}`, options);
+  }
+  async remove(projectId, membershipId) {
+    return this._r("DELETE", `/api/im/projects/${projectId}/members/${membershipId}`);
+  }
+};
+var ProjectsClient = class {
+  constructor(_r) {
+    this._r = _r;
+    this.members = new ProjectMembersClient(_r);
+  }
+  async list(options) {
+    const query = { workspaceId: options.workspaceId };
+    if (options.status) query.status = options.status;
+    if (options.search) query.search = options.search;
+    if (options.limit !== void 0) query.limit = String(options.limit);
+    if (options.offset !== void 0) query.offset = String(options.offset);
+    return this._r("GET", "/api/im/projects", void 0, query);
+  }
+  async create(options) {
+    return this._r("POST", "/api/im/projects", options);
+  }
+  async get(projectId) {
+    return this._r("GET", `/api/im/projects/${projectId}`);
+  }
+  async update(projectId, options) {
+    return this._r("PATCH", `/api/im/projects/${projectId}`, options);
+  }
+  async delete(projectId, options) {
+    const query = {};
+    if (options?.cascade) query.cascade = options.cascade;
+    return this._r("DELETE", `/api/im/projects/${projectId}`, void 0, query);
+  }
 };
 var WorkspaceFilesClient = class {
   constructor(_r) {
@@ -5033,10 +5324,18 @@ var RuntimeInstallationsClient = class {
   constructor(_r) {
     this._r = _r;
   }
-  /** List runtime installations in a workspace. */
+  /**
+   * List runtime installations in a workspace.
+   *
+   * v2.0.8 M448 (release201/20 §1) — `projectId` narrows scope:
+   *   - omitted | `'all'`  → no project filter (legacy behaviour)
+   *   - `'__unscoped'`     → only workspace-level rows (projectId IS NULL)
+   *   - any other string   → exact projectId match
+   */
   async list(workspaceId, options) {
     const query = { workspaceId };
     if (options?.limit != null) query.limit = String(options.limit);
+    if (options?.projectId) query.projectId = options.projectId;
     return this._r("GET", "/api/workspace/runtime-installations", void 0, query);
   }
   /**
@@ -5045,10 +5344,27 @@ var RuntimeInstallationsClient = class {
    * The daemon receives `PRISMER_API_KEY`, `PRISMER_DAEMON_ID`,
    * `PRISMER_BASE_URL`, `PRISMER_WORKSPACE_ID`, and
    * `PRISMER_RUNTIME_KIND=workspace-daemon` env vars.
+   *
+   * v2.0.8 M448 — `options.projectId` (optional) opts into project scope.
+   * Server validates it belongs to the same workspace and is `active`,
+   * otherwise rejects 422 `PROJECT_WORKSPACE_MISMATCH` / `PROJECT_NOT_ACTIVE`.
    */
   async create(options) {
     return this._r("POST", "/api/workspace/runtime-installations", options);
   }
+  /**
+   * v2.0.8 M448 (release201/20 §1) — update the project binding on an
+   * existing runtime installation. Pass `projectId: null` to detach.
+   * No-op when body omits `projectId`. Same workspace/active invariant as
+   * create — returns 422 on mismatch.
+   */
+  async patch(runtimeInstallationId, options) {
+    return this._r(
+      "PATCH",
+      `/api/workspace/runtime-installations/${runtimeInstallationId}`,
+      options
+    );
+  }
   /**
    * Install an agent onto a runtime daemon. Resolves or creates the agent
    * profile, calls the controller's `installAgent` RPC, and stamps
@@ -5181,6 +5497,19 @@ var FilesClient = class {
    */
   async sendFile(conversationId, input, opts) {
     const uploaded = await this.upload(input, opts);
+    const outboxDir = process.env.PRISMER_OUTBOX_DIR;
+    if (outboxDir) {
+      try {
+        const fsMod = await import("fs");
+        const pathMod = await import("path");
+        const srcPath = typeof input === "string" ? input : input.path;
+        if (srcPath && typeof srcPath === "string") {
+          await fsMod.promises.mkdir(outboxDir, { recursive: true });
+          fsMod.cpSync(srcPath, pathMod.join(outboxDir, pathMod.basename(srcPath)));
+        }
+      } catch {
+      }
+    }
     const msgRes = await this._r("POST", `/api/im/messages/${conversationId}`, {
       content: opts?.content || uploaded.fileName,
       type: "file",
@@ -5389,6 +5718,36 @@ var IMRealtimeClient = class {
     };
   }
 };
+var SkillsDraftClient = class {
+  constructor(_r) {
+    this._r = _r;
+  }
+  /** Create a draft skill from a manifest v1 payload. */
+  async create(input) {
+    return this._r("POST", "/api/im/skills/draft", input);
+  }
+  /** Apply incremental file ops to a draft. */
+  async patch(id, input) {
+    return this._r("PATCH", `/api/im/skills/${id}/draft`, input);
+  }
+  /** Request a regenerate session for a draft. */
+  async regenerate(id, input) {
+    return this._r("POST", `/api/im/skills/${id}/draft/regenerate`, input);
+  }
+  /** Fetch a single draft's manifest + revision history. */
+  async show(id) {
+    return this._r("GET", `/api/im/skills/draft/${id}`);
+  }
+  /** List drafts for a workspace (most-recently-updated first). */
+  async list(workspaceId) {
+    return this._r("GET", "/api/im/skills/drafts", void 0, { workspaceId });
+  }
+};
+var SkillsClient = class {
+  constructor(_r) {
+    this.draft = new SkillsDraftClient(_r);
+  }
+};
 var IMClient = class {
   constructor(request, wsBase, fetchFn, getAuthHeaders, offlineManager, communityHubConfig) {
     this._request = request;
@@ -5402,16 +5761,22 @@ var IMClient = class {
     this.credits = new CreditsClient(request);
     this.workspace = new WorkspaceClient(request);
     this.workspaces = new WorkspacesClient(request);
+    this.invites = new InvitesClient(request);
+    this.projects = new ProjectsClient(request);
     this.workspaceFiles = new WorkspaceFilesClient(request);
     this.assets = new AssetsClient(request, wsBase, fetchFn, getAuthHeaders);
     this.runtimeInstallations = new RuntimeInstallationsClient(request);
     this.tasks = new TasksClient(request);
+    this.criteriaTemplates = new CriteriaTemplatesClient(request);
     this.memory = new MemoryClient(request);
     this.knowledge = new KnowledgeLinkClient(request);
+    this.metrics = new MetricsClient(request);
     this.identity = new IdentityClient(request);
     this.security = new SecurityClient(request);
     this.agents = new AgentsClient(request);
     this.evolution = new EvolutionClient(request);
+    this.skills = new SkillsClient(request);
+    this.studio = new StudioClient(request);
     this.community = new CommunityHub(request, communityHubConfig ?? void 0);
     this.files = new FilesClient(request, wsBase, fetchFn, getAuthHeaders);
     this.realtime = new IMRealtimeClient(wsBase, fetchFn);
@@ -5461,6 +5826,7 @@ var PrismerClient = class {
     this.timeout = config.timeout || 3e4;
     this.fetchFn = config.fetch || fetch;
     this.imAgent = config.imAgent;
+    this.imWorkspace = config.imWorkspace;
     if (config.identity) {
       if (config.identity === "auto" && this.apiKey) {
         this._identityReady = AIPIdentity.fromApiKey(this.apiKey).then((id) => {
@@ -5519,6 +5885,8 @@ var PrismerClient = class {
       config.community ?? null
     );
     this.workspaces = this.im.workspaces;
+    this.invites = this.im.invites;
+    this.projects = this.im.projects;
     this.workspaceFiles = this.im.workspaceFiles;
     this.assets = this.im.assets;
     this.evolution = this.im.evolution;
@@ -5555,6 +5923,7 @@ var PrismerClient = class {
     const headers = {};
     if (this.apiKey) headers["Authorization"] = `Bearer ${this.apiKey}`;
     if (this.imAgent) headers["X-IM-Agent"] = this.imAgent;
+    if (this.imWorkspace) headers["X-IM-Workspace"] = this.imWorkspace;
     return headers;
   }
   /**
@@ -5621,6 +5990,9 @@ var PrismerClient = class {
       if (this.imAgent) {
         headers["X-IM-Agent"] = this.imAgent;
       }
+      if (this.imWorkspace) {
+        headers["X-IM-Workspace"] = this.imWorkspace;
+      }
       if (opts?.headers) {
         for (const [k, v] of Object.entries(opts.headers)) headers[k] = v;
       }
@@ -5729,6 +6101,7 @@ function createClient(config) {
 export {
   AIPIdentity,
   AccountClient,
+  AgentSkillsClient,
   AgentsClient,
   AssetsClient,
   AttachmentQueue,
@@ -5737,6 +6110,7 @@ export {
   ContactsClient,
   ConversationsClient,
   CreditsClient,
+  CriteriaTemplatesClient,
   DirectClient,
   E2EEncryption,
   ENVIRONMENTS,
@@ -5750,22 +6124,32 @@ export {
   IMRealtimeClient,
   IdentityClient,
   IndexedDBStorage,
+  InvitesClient,
   KnowledgeLinkClient,
   MemoryClient,
   MemoryStorage,
   MessagesClient,
+  MetricsClient,
   OfflineManager,
   PrismerClient,
+  ProjectMembersClient,
+  ProjectsClient,
   RealtimeSSEClient,
   RealtimeWSClient,
   RuntimeInstallationsClient,
   SQLiteStorage,
   SecurityClient,
+  SkillsClient,
+  SkillsDraftClient,
+  StudioClient,
+  StudioEvolutionClient,
   TabCoordinator,
   TasksClient,
   WORKSPACE_ASSETS_ROUTE,
   WorkspaceClient,
   WorkspaceFilesClient,
+  WorkspaceInvitesClient,
+  WorkspaceMembersClient,
   WorkspacesClient,
   createClient,
   createEnrichedExtractor,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prismer/sdk",
-  "version": "2.0.6",
+  "version": "2.0.8",
   "description": "Official TypeScript SDK for Prismer Cloud API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",