@diskd-ai/sdk 5.1.2

package/dist/operatives/operatives.js

@@ -0,0 +1,199 @@
+import { resolveDiskdGatewayUrl } from '../env/baseUrl.js';
+import { httpRequest, resolveAuthHeaders } from '../sdk/http.js';
+// ---------------------------------------------------------------------------
+// Decode / encode
+// ---------------------------------------------------------------------------
+const decodeOperative = (wire) => {
+    const base = {
+        id: wire.id,
+        workspaceId: wire.workspaceId,
+        name: wire.name,
+        slug: wire.slug,
+        avatarUrl: wire.avatarUrl,
+        fileAccess: wire.intelAccess,
+        engineProvider: wire.engineProvider,
+        engineModel: wire.engineModel,
+        engine: wire.engine,
+        orders: wire.orders,
+        ordersUpdatedAt: wire.ordersUpdatedAt,
+        trustLevel: wire.trustLevel,
+        isPrimary: wire.isPrimary,
+        status: wire.status,
+        sealGradient: wire.sealGradient,
+        createdBy: wire.createdBy,
+        createdAt: wire.createdAt,
+        updatedAt: wire.updatedAt,
+    };
+    if (wire.scope === 'workspace' || wire.projectId === null) {
+        return { ...base, scope: 'workspace' };
+    }
+    return { ...base, scope: 'project', projectId: wire.projectId };
+};
+const decodeFile = (wire) => ({
+    id: wire.id,
+    operativeId: wire.operativeId,
+    path: wire.sourceId,
+    createdAt: wire.createdAt,
+});
+const decodeSkill = (wire) => ({
+    id: wire.id,
+    operativeId: wire.operativeId,
+    refId: wire.refId ?? '',
+    createdAt: wire.createdAt,
+});
+const decodeTool = (wire) => ({
+    id: wire.id,
+    operativeId: wire.operativeId,
+    selector: wire.selector ?? '',
+    display: wire.display,
+    resolutionStatus: wire.resolutionStatus,
+    createdAt: wire.createdAt,
+});
+/** Encode SDK field names to app-service wire format. */
+const encodeParams = (params) => {
+    const wire = { ...params };
+    if ('fileAccess' in wire) {
+        wire.intelAccess = wire.fileAccess;
+        delete wire.fileAccess;
+    }
+    return wire;
+};
+// ---------------------------------------------------------------------------
+// Query params
+// ---------------------------------------------------------------------------
+const buildQuery = (entries) => {
+    const parts = [];
+    for (const [key, value] of entries) {
+        if (value !== undefined) {
+            parts.push(`${key}=${encodeURIComponent(value)}`);
+        }
+    }
+    return parts.length > 0 ? `?${parts.join('&')}` : '';
+};
+// ---------------------------------------------------------------------------
+// Client factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates an Operatives REST client bound to a given auth module.
+ *
+ * The URL defaults to the centralized `APIS_BASE_URL` gateway with the
+ * `/v1/platform/operatives` path prefix.
+ *
+ * Example:
+ * ```ts
+ * const ops = createOperativesClient({ auth });
+ * const list = await ops.list({ projectId: 'proj-1' });
+ * await ops.files.add('op-01', { paths: ['/docs/notes'] });
+ * await ops.skills.add('op-01', { refIds: ['web-search'] });
+ * await ops.tools.add('op-01', { selectors: ['github/search_repos'] });
+ * ```
+ */
+export const createOperativesClient = (params) => {
+    const baseUrl = (params.url ?? resolveDiskdGatewayUrl('platform/operatives')).replace(/\/+$/, '');
+    const request = async (method, path, opts = {}) => {
+        const authHeaders = await resolveAuthHeaders(params.auth);
+        return httpRequest({
+            method,
+            url: `${baseUrl}${path}`,
+            authHeaders,
+            body: opts.body,
+        }, 'Operatives');
+    };
+    const encId = (id) => encodeURIComponent(id);
+    return {
+        list: async (listParams) => {
+            const query = buildQuery([['projectId', listParams.projectId]]);
+            const items = await request('GET', `/api/operatives${query}`);
+            return items.map(decodeOperative);
+        },
+        listWorkspace: async () => {
+            const response = await request('GET', '/api/workspace-operatives');
+            return response.items.map(decodeOperative);
+        },
+        get: async (operativeId) => {
+            const wire = await request('GET', `/api/operatives/${encId(operativeId)}`);
+            return decodeOperative(wire);
+        },
+        getBySlug: async (slugParams) => {
+            const query = buildQuery([
+                ['projectId', slugParams.projectId],
+                ['slug', slugParams.slug],
+            ]);
+            const wire = await request('GET', `/api/operatives/by-slug${query}`);
+            return decodeOperative(wire);
+        },
+        create: async (createParams) => {
+            const wire = await request('POST', '/api/operatives', {
+                body: encodeParams({ ...createParams }),
+            });
+            return decodeOperative(wire);
+        },
+        update: async (operativeId, updateParams) => {
+            const wire = await request('PATCH', `/api/operatives/${encId(operativeId)}`, {
+                body: encodeParams({ ...updateParams }),
+            });
+            return decodeOperative(wire);
+        },
+        delete: async (operativeId) => {
+            await request('DELETE', `/api/operatives/${encId(operativeId)}`);
+        },
+        files: {
+            list: async (operativeId) => {
+                const items = await request('GET', `/api/operatives/${encId(operativeId)}/intel`);
+                return items.map(decodeFile);
+            },
+            add: async (operativeId, addParams) => {
+                const results = [];
+                for (const path of addParams.paths) {
+                    const wire = await request('POST', `/api/operatives/${encId(operativeId)}/intel`, {
+                        body: { sourceId: path },
+                    });
+                    results.push(decodeFile(wire));
+                }
+                return results;
+            },
+            remove: async (operativeId, linkId) => {
+                await request('DELETE', `/api/operatives/${encId(operativeId)}/intel/${encId(linkId)}`);
+            },
+        },
+        skills: {
+            list: async (operativeId) => {
+                const result = await request('GET', `/api/operatives/${encId(operativeId)}/equipment`);
+                return result.items.filter((e) => e.equipmentType === 'skill').map(decodeSkill);
+            },
+            add: async (operativeId, addParams) => {
+                const results = [];
+                for (const refId of addParams.refIds) {
+                    const wire = await request('POST', `/api/operatives/${encId(operativeId)}/equipment`, {
+                        body: { equipmentType: 'skill', refId },
+                    });
+                    results.push(decodeSkill(wire));
+                }
+                return results;
+            },
+            remove: async (operativeId, linkId) => {
+                await request('DELETE', `/api/operatives/${encId(operativeId)}/equipment/${encId(linkId)}`);
+            },
+        },
+        tools: {
+            list: async (operativeId) => {
+                const result = await request('GET', `/api/operatives/${encId(operativeId)}/equipment`);
+                return result.items.filter((e) => e.equipmentType === 'mcp_tool').map(decodeTool);
+            },
+            add: async (operativeId, addParams) => {
+                const results = [];
+                for (const selector of addParams.selectors) {
+                    const wire = await request('POST', `/api/operatives/${encId(operativeId)}/equipment`, {
+                        body: { equipmentType: 'mcp_tool', selector },
+                    });
+                    results.push(decodeTool(wire));
+                }
+                return results;
+            },
+            remove: async (operativeId, linkId) => {
+                await request('DELETE', `/api/operatives/${encId(operativeId)}/equipment/${encId(linkId)}`);
+            },
+        },
+    };
+};
+//# sourceMappingURL=operatives.js.map

package/dist/operatives/operatives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operatives.js","sourceRoot":"","sources":["../../src/operatives/operatives.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAmB,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAkElF,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,eAAe,GAAG,CAAC,IAAmB,EAAa,EAAE;IACzD,MAAM,IAAI,GAAG;QACX,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,UAAU,EAAE,IAAI,CAAC,WAAW;QAC5B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC;IAEF,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC1D,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IACzC,CAAC;IAED,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;AAClE,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,IAAe,EAAiB,EAAE,CAAC,CAAC;IACtD,EAAE,EAAE,IAAI,CAAC,EAAE;IACX,WAAW,EAAE,IAAI,CAAC,WAAW;IAC7B,IAAI,EAAE,IAAI,CAAC,QAAQ;IACnB,SAAS,EAAE,IAAI,CAAC,SAAS;CAC1B,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,CAAC,IAAmB,EAAkB,EAAE,CAAC,CAAC;IAC5D,EAAE,EAAE,IAAI,CAAC,EAAE;IACX,WAAW,EAAE,IAAI,CAAC,WAAW;IAC7B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;IACvB,SAAS,EAAE,IAAI,CAAC,SAAS;CAC1B,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,CAAC,IAAmB,EAAiB,EAAE,CAAC,CAAC;IAC1D,EAAE,EAAE,IAAI,CAAC,EAAE;IACX,WAAW,EAAE,IAAI,CAAC,WAAW;IAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;IAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;IACrB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;IACvC,SAAS,EAAE,IAAI,CAAC,SAAS;CAC1B,CAAC,CAAC;AAEH,yDAAyD;AACzD,MAAM,YAAY,GAAG,CAAC,MAA+B,EAA2B,EAAE;IAChF,MAAM,IAAI,GAA4B,EAAE,GAAG,MAAM,EAAE,CAAC;IACpD,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC;QACnC,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,MAAM,UAAU,GAAG,CAAC,OAA2D,EAAU,EAAE;IACzF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QACnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvD,CAAC,CAAC;AAEF,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,MAGtC,EAAoB,EAAE;IACrB,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,sBAAsB,CAAC,qBAAqB,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAElG,MAAM,OAAO,GAAG,KAAK,EACnB,MAAkB,EAClB,IAAY,EACZ,OAAoC,EAAE,EAC1B,EAAE;QACd,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1D,OAAO,WAAW,CAChB;YACE,MAAM;YACN,GAAG,EAAE,GAAG,OAAO,GAAG,IAAI,EAAE;YACxB,WAAW;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,EACD,YAAY,CACb,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,CAAC,EAAU,EAAU,EAAE,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAE7D,OAAO;QACL,IAAI,EAAE,KAAK,EAAE,UAA+B,EAAiC,EAAE;YAC7E,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,WAAW,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YAChE,MAAM,KAAK,GAAG,MAAM,OAAO,CAA2B,KAAK,EAAE,kBAAkB,KAAK,EAAE,CAAC,CAAC;YACxF,OAAO,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACpC,CAAC;QAED,aAAa,EAAE,KAAK,IAAmC,EAAE;YACvD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAC5B,KAAK,EACL,2BAA2B,CAC5B,CAAC;YACF,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC7C,CAAC;QAED,GAAG,EAAE,KAAK,EAAE,WAAmB,EAAsB,EAAE;YACrD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAgB,KAAK,EAAE,mBAAmB,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YAC1F,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QAED,SAAS,EAAE,KAAK,EAAE,UAAoC,EAAsB,EAAE;YAC5E,MAAM,KAAK,GAAG,UAAU,CAAC;gBACvB,CAAC,WAAW,EAAE,UAAU,CAAC,SAAS,CAAC;gBACnC,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC;aAC1B,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAgB,KAAK,EAAE,0BAA0B,KAAK,EAAE,CAAC,CAAC;YACpF,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,YAAmC,EAAsB,EAAE;YACxE,MAAM,IAAI,GAAG,MAAM,OAAO,CAAgB,MAAM,EAAE,iBAAiB,EAAE;gBACnE,IAAI,EAAE,YAAY,CAAC,EAAE,GAAG,YAAY,EAAE,CAAC;aACxC,CAAC,CAAC;YACH,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QAED,MAAM,EAAE,KAAK,EACX,WAAmB,EACnB,YAAmC,EACf,EAAE;YACtB,MAAM,IAAI,GAAG,MAAM,OAAO,CAAgB,OAAO,EAAE,mBAAmB,KAAK,CAAC,WAAW,CAAC,EAAE,EAAE;gBAC1F,IAAI,EAAE,YAAY,CAAC,EAAE,GAAG,YAAY,EAAE,CAAC;aACxC,CAAC,CAAC;YACH,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,WAAmB,EAAiB,EAAE;YACnD,MAAM,OAAO,CAAU,QAAQ,EAAE,mBAAmB,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,KAAK,EAAE;YACL,IAAI,EAAE,KAAK,EAAE,WAAmB,EAAqC,EAAE;gBACrE,MAAM,KAAK,GAAG,MAAM,OAAO,CACzB,KAAK,EACL,mBAAmB,KAAK,CAAC,WAAW,CAAC,QAAQ,CAC9C,CAAC;gBACF,OAAO,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC/B,CAAC;YAED,GAAG,EAAE,KAAK,EACR,WAAmB,EACnB,SAAkC,EACC,EAAE;gBACrC,MAAM,OAAO,GAAoB,EAAE,CAAC;gBACpC,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;oBACnC,MAAM,IAAI,GAAG,MAAM,OAAO,CACxB,MAAM,EACN,mBAAmB,KAAK,CAAC,WAAW,CAAC,QAAQ,EAC7C;wBACE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;qBACzB,CACF,CAAC;oBACF,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;gBACjC,CAAC;gBACD,OAAO,OAAO,CAAC;YACjB,CAAC;YAED,MAAM,EAAE,KAAK,EAAE,WAAmB,EAAE,MAAc,EAAiB,EAAE;gBACnE,MAAM,OAAO,CACX,QAAQ,EACR,mBAAmB,KAAK,CAAC,WAAW,CAAC,UAAU,KAAK,CAAC,MAAM,CAAC,EAAE,CAC/D,CAAC;YACJ,CAAC;SACF;QAED,MAAM,EAAE;YACN,IAAI,EAAE,KAAK,EAAE,WAAmB,EAAsC,EAAE;gBACtE,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,KAAK,EACL,mBAAmB,KAAK,CAAC,WAAW,CAAC,YAAY,CAClD,CAAC;gBACF,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAClF,CAAC;YAED,GAAG,EAAE,KAAK,EACR,WAAmB,EACnB,SAAmC,EACC,EAAE;gBACtC,MAAM,OAAO,GAAqB,EAAE,CAAC;gBACrC,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;oBACrC,MAAM,IAAI,GAAG,MAAM,OAAO,CACxB,MAAM,EACN,mBAAmB,KAAK,CAAC,WAAW,CAAC,YAAY,EACjD;wBACE,IAAI,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE;qBACxC,CACF,CAAC;oBACF,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;gBAClC,CAAC;gBACD,OAAO,OAAO,CAAC;YACjB,CAAC;YAED,MAAM,EAAE,KAAK,EAAE,WAAmB,EAAE,MAAc,EAAiB,EAAE;gBACnE,MAAM,OAAO,CACX,QAAQ,EACR,mBAAmB,KAAK,CAAC,WAAW,CAAC,cAAc,KAAK,CAAC,MAAM,CAAC,EAAE,CACnE,CAAC;YACJ,CAAC;SACF;QAED,KAAK,EAAE;YACL,IAAI,EAAE,KAAK,EAAE,WAAmB,EAAqC,EAAE;gBACrE,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,KAAK,EACL,mBAAmB,KAAK,CAAC,WAAW,CAAC,YAAY,CAClD,CAAC;gBACF,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,UAAU,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACpF,CAAC;YAED,GAAG,EAAE,KAAK,EACR,WAAmB,EACnB,SAAkC,EACC,EAAE;gBACrC,MAAM,OAAO,GAAoB,EAAE,CAAC;gBACpC,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;oBAC3C,MAAM,IAAI,GAAG,MAAM,OAAO,CACxB,MAAM,EACN,mBAAmB,KAAK,CAAC,WAAW,CAAC,YAAY,EACjD;wBACE,IAAI,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE;qBAC9C,CACF,CAAC;oBACF,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;gBACjC,CAAC;gBACD,OAAO,OAAO,CAAC;YACjB,CAAC;YAED,MAAM,EAAE,KAAK,EAAE,WAAmB,EAAE,MAAc,EAAiB,EAAE;gBACnE,MAAM,OAAO,CACX,QAAQ,EACR,mBAAmB,KAAK,CAAC,WAAW,CAAC,cAAc,KAAK,CAAC,MAAM,CAAC,EAAE,CACnE,CAAC;YACJ,CAAC;SACF;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/operatives/operativesTypes.d.ts

@@ -0,0 +1,141 @@
+export type OperativeEngine = 'quick' | 'deep';
+export type OperativeFileAccess = 'all' | 'selected';
+export type OperativeStatus = 'active' | 'standby';
+export type OperativeTrustLevel = 0 | 1 | 2 | 3;
+export type OperativeScope = 'project' | 'workspace';
+type OperativeBase = {
+    readonly id: string;
+    readonly workspaceId: string;
+    readonly name: string;
+    readonly slug: string;
+    readonly avatarUrl?: string;
+    readonly engineProvider?: string;
+    readonly engineModel?: string;
+    readonly engine: OperativeEngine;
+    readonly orders: string;
+    readonly ordersUpdatedAt?: string;
+    readonly fileAccess: OperativeFileAccess;
+    readonly trustLevel: OperativeTrustLevel;
+    readonly isPrimary: boolean;
+    readonly status: OperativeStatus;
+    readonly sealGradient?: readonly [string, string];
+    readonly createdBy?: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+};
+export type ProjectScopedOperative = OperativeBase & {
+    readonly scope: 'project';
+    readonly projectId: string;
+};
+export type WorkspaceScopedOperative = OperativeBase & {
+    readonly scope: 'workspace';
+};
+export type Operative = ProjectScopedOperative | WorkspaceScopedOperative;
+export declare const isProjectScoped: (op: Operative) => op is ProjectScopedOperative;
+export declare const isWorkspaceScoped: (op: Operative) => op is WorkspaceScopedOperative;
+export type OperativeFile = {
+    readonly id: string;
+    readonly operativeId: string;
+    /** Drive path relative to the operative's project chroot. */
+    readonly path: string;
+    readonly createdAt: string;
+};
+export type OperativeSkill = {
+    readonly id: string;
+    readonly operativeId: string;
+    readonly refId: string;
+    readonly createdAt: string;
+};
+export type OperativeTool = {
+    readonly id: string;
+    readonly operativeId: string;
+    readonly selector: string;
+    readonly display?: {
+        readonly serverName: string;
+        readonly toolName: string;
+    };
+    readonly resolutionStatus?: 'valid' | 'disabled_globally' | 'unknown';
+    readonly createdAt: string;
+};
+export type OperativeListParams = {
+    readonly projectId: string;
+};
+export type OperativeGetBySlugParams = {
+    readonly projectId: string;
+    readonly slug: string;
+};
+export type OperativeCreateParams = {
+    readonly projectId: string;
+    readonly name: string;
+    readonly slug?: string;
+    readonly orders?: string;
+    readonly engineProvider?: string;
+    readonly engineModel?: string;
+    readonly engine?: OperativeEngine;
+};
+export type OperativeUpdateParams = {
+    readonly name?: string;
+    readonly slug?: string;
+    readonly avatarUrl?: string;
+    readonly engineProvider?: string;
+    readonly engineModel?: string;
+    readonly engine?: OperativeEngine;
+    readonly orders?: string;
+    readonly ordersUpdatedAt?: string;
+    readonly fileAccess?: OperativeFileAccess;
+    readonly trustLevel?: OperativeTrustLevel;
+    readonly status?: OperativeStatus;
+    readonly sealGradient?: readonly [string, string];
+};
+export type OperativeAddFilesParams = {
+    /** Drive paths relative to the operative's project chroot. */
+    readonly paths: readonly string[];
+};
+export type OperativeAddSkillsParams = {
+    readonly refIds: readonly string[];
+};
+export type OperativeAddToolsParams = {
+    readonly selectors: readonly string[];
+};
+/**
+ * Operatives REST client with files, skills, and tools sub-namespaces.
+ *
+ * Obtain via `diskd.platform.operatives({ auth })`.
+ * Maps to the app-service `/api/operatives` endpoints.
+ */
+export type OperativesClient = {
+    /** GET /api/operatives?projectId=... -- list operatives in a project. */
+    readonly list: (params: OperativeListParams) => Promise<readonly Operative[]>;
+    /** GET /api/workspace-operatives -- list workspace-scoped operatives. */
+    readonly listWorkspace: () => Promise<readonly Operative[]>;
+    /** GET /api/operatives/:operativeId -- get a single operative by id. */
+    readonly get: (operativeId: string) => Promise<Operative>;
+    /** GET /api/operatives/by-slug?projectId=...&slug=... -- get by slug within a project. */
+    readonly getBySlug: (params: OperativeGetBySlugParams) => Promise<Operative>;
+    /** POST /api/operatives -- create a new operative. */
+    readonly create: (params: OperativeCreateParams) => Promise<Operative>;
+    /** PATCH /api/operatives/:operativeId -- update an existing operative. */
+    readonly update: (operativeId: string, params: OperativeUpdateParams) => Promise<Operative>;
+    /** DELETE /api/operatives/:operativeId -- delete an operative. */
+    readonly delete: (operativeId: string) => Promise<void>;
+    /** Drive files attached to the operative (knowledge sources). */
+    readonly files: {
+        readonly list: (operativeId: string) => Promise<readonly OperativeFile[]>;
+        readonly add: (operativeId: string, params: OperativeAddFilesParams) => Promise<readonly OperativeFile[]>;
+        readonly remove: (operativeId: string, linkId: string) => Promise<void>;
+    };
+    /** Skills attached to the operative. */
+    readonly skills: {
+        readonly list: (operativeId: string) => Promise<readonly OperativeSkill[]>;
+        readonly add: (operativeId: string, params: OperativeAddSkillsParams) => Promise<readonly OperativeSkill[]>;
+        readonly remove: (operativeId: string, linkId: string) => Promise<void>;
+    };
+    /** MCP tools attached to the operative. */
+    readonly tools: {
+        readonly list: (operativeId: string) => Promise<readonly OperativeTool[]>;
+        readonly add: (operativeId: string, params: OperativeAddToolsParams) => Promise<readonly OperativeTool[]>;
+        readonly remove: (operativeId: string, linkId: string) => Promise<void>;
+    };
+};
+export {};
+//# sourceMappingURL=operativesTypes.d.ts.map

package/dist/operatives/operativesTypes.d.ts.map

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

package/dist/operatives/operativesTypes.js

@@ -0,0 +1,6 @@
+// Operative domain types.
+// Wire mapping (intelAccess -> fileAccess, sourceId -> path, equipmentType hidden)
+// is handled in the client factory.
+export const isProjectScoped = (op) => op.scope === 'project';
+export const isWorkspaceScoped = (op) => op.scope === 'workspace';
+//# sourceMappingURL=operativesTypes.js.map

package/dist/operatives/operativesTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operativesTypes.js","sourceRoot":"","sources":["../../src/operatives/operativesTypes.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,mFAAmF;AACnF,oCAAoC;AA+CpC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAa,EAAgC,EAAE,CAC7E,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;AAEzB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,EAAa,EAAkC,EAAE,CACjF,EAAE,CAAC,KAAK,KAAK,WAAW,CAAC"}

package/dist/platformEvents/platformEvents.d.ts

@@ -0,0 +1,14 @@
+/**
+ * HTTP client for Platform Events.
+ *
+ * Publishes domain events via POST /publish to the app-service events endpoint,
+ * which constructs an envelope and publishes to NATS JetStream directly.
+ */
+import type { AuthModule } from '../auth/types.js';
+import type { PlatformEventsClient } from './platformEventsTypes.js';
+export type CreatePlatformEventsClientParams = {
+    readonly auth: AuthModule;
+    readonly url?: string;
+};
+export declare const createPlatformEventsClient: (params: CreatePlatformEventsClientParams) => PlatformEventsClient;
+//# sourceMappingURL=platformEvents.d.ts.map

package/dist/platformEvents/platformEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platformEvents.d.ts","sourceRoot":"","sources":["../../src/platformEvents/platformEvents.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EACV,oBAAoB,EAIrB,MAAM,0BAA0B,CAAC;AAmDlC,MAAM,MAAM,gCAAgC,GAAG;IAC7C,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,QAAQ,gCAAgC,KACvC,oBAuCF,CAAC"}

package/dist/platformEvents/platformEvents.js

@@ -0,0 +1,70 @@
+import { resolveDiskdGatewayUrl } from '../env/baseUrl.js';
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+// ---------------------------------------------------------------------------
+// Response decoding (pure)
+// ---------------------------------------------------------------------------
+const decodePublishResult = (raw) => {
+    if (!isObject(raw)) {
+        throw new Error('Invalid Platform Events response: expected object');
+    }
+    const id = raw.id;
+    const subject = raw.subject;
+    if (typeof id !== 'string' || typeof subject !== 'string') {
+        throw new Error('Invalid Platform Events response: missing id or subject');
+    }
+    return { id, subject };
+};
+// ---------------------------------------------------------------------------
+// Auth header resolution
+// ---------------------------------------------------------------------------
+const resolveAuthHeaders = async (auth) => {
+    if (auth.getRequestHeaders) {
+        return auth.getRequestHeaders();
+    }
+    const token = await auth.getAccessToken();
+    return { Authorization: `Bearer ${token}` };
+};
+const resolveWorkspaceId = async (auth) => {
+    const workspaceId = await auth.getWorkspaceId();
+    if (workspaceId.length > 0) {
+        return workspaceId;
+    }
+    throw new Error('Platform Events: AuthModule must include a workspaceId');
+};
+export const createPlatformEventsClient = (params) => {
+    const baseUrl = params.url ?? resolveDiskdGatewayUrl('platform/events');
+    const publish = async (eventParams) => {
+        const authHeaders = await resolveAuthHeaders(params.auth);
+        const workspaceId = await resolveWorkspaceId(params.auth);
+        const response = await fetch(`${baseUrl}/publish`, {
+            method: 'POST',
+            headers: {
+                ...authHeaders,
+                'Content-Type': 'application/json',
+                'X-Workspace-Id': workspaceId,
+            },
+            body: JSON.stringify({
+                subject: eventParams.subject,
+                data: eventParams.data,
+            }),
+        });
+        if (!response.ok) {
+            let errorMessage = `Platform Events: HTTP ${response.status}`;
+            try {
+                const errorBody = (await response.json());
+                if (isObject(errorBody)) {
+                    const err = errorBody;
+                    errorMessage = `Platform Events: ${err.error}`;
+                }
+            }
+            catch {
+                // Response body not JSON -- use status-only message.
+            }
+            throw new Error(errorMessage);
+        }
+        const body = await response.json();
+        return decodePublishResult(body);
+    };
+    return { publish };
+};
+//# sourceMappingURL=platformEvents.js.map

package/dist/platformEvents/platformEvents.js.map

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

package/dist/platformEvents/platformEventsTypes.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Types for the Platform Events client.
+ *
+ * Events are published to the app-service events endpoint at POST /publish
+ * and forwarded to the NATS JetStream stream PLATFORM_EVENTS.
+ */
+/** Parameters for publishing a domain event via the app-service events endpoint. */
+export type PublishEventParams = {
+    /** Event type (e.g., "email.received"). Must be in the bridge allowlist. */
+    readonly subject: string;
+    /** Arbitrary event payload (JSON-serializable). */
+    readonly data: Readonly<Record<string, unknown>>;
+};
+/** Result returned after a successful publish (HTTP 202). */
+export type PublishEventResult = {
+    /** ULID assigned to the event by the bridge. */
+    readonly id: string;
+    /** Full NATS subject (e.g., "platform.ws_01ABC.email.received"). */
+    readonly subject: string;
+};
+/** Error shape returned by the NATS Bridge on failure (4xx/5xx). */
+export type PublishEventError = {
+    readonly error: string;
+    readonly allowed?: readonly string[];
+};
+/** Platform Events client interface. */
+export type PlatformEventsClient = {
+    /** Publish a domain event to the NATS event bus. */
+    readonly publish: (params: PublishEventParams) => Promise<PublishEventResult>;
+};
+//# sourceMappingURL=platformEventsTypes.d.ts.map

package/dist/platformEvents/platformEventsTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platformEventsTypes.d.ts","sourceRoot":"","sources":["../../src/platformEvents/platformEventsTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oFAAoF;AACpF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAClD,CAAC;AAEF,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,oEAAoE;AACpE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC,CAAC;AAEF,wCAAwC;AACxC,MAAM,MAAM,oBAAoB,GAAG;IACjC,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC/E,CAAC"}

package/dist/platformEvents/platformEventsTypes.js

@@ -0,0 +1,8 @@
+/**
+ * Types for the Platform Events client.
+ *
+ * Events are published to the app-service events endpoint at POST /publish
+ * and forwarded to the NATS JetStream stream PLATFORM_EVENTS.
+ */
+export {};
+//# sourceMappingURL=platformEventsTypes.js.map

package/dist/platformEvents/platformEventsTypes.js.map

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

package/dist/projects/projects.d.ts

@@ -0,0 +1,19 @@
+import type { AuthModule } from '../auth/types.js';
+import type { ProjectsClient } from './projectsTypes.js';
+/**
+ * Creates a Projects REST client bound to a given auth module.
+ *
+ * The URL defaults to the centralized `APIS_BASE_URL` gateway with the
+ * `/v1/platform/projects` path prefix.
+ *
+ * Example:
+ * ```ts
+ * const projects = createProjectsClient({ auth });
+ * const all = await projects.list();
+ * ```
+ */
+export declare const createProjectsClient: (params: {
+    readonly auth: AuthModule;
+    readonly url?: string;
+}) => ProjectsClient;
+//# sourceMappingURL=projects.d.ts.map

package/dist/projects/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/projects/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,KAAK,EAIV,cAAc,EAEf,MAAM,oBAAoB,CAAC;AAM5B;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ;IAC3C,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB,KAAG,cA+CH,CAAC"}

package/dist/projects/projects.js

@@ -0,0 +1,52 @@
+import { resolveDiskdGatewayUrl } from '../env/baseUrl.js';
+import { httpRequest, resolveAuthHeaders } from '../sdk/http.js';
+// ---------------------------------------------------------------------------
+// Client factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates a Projects REST client bound to a given auth module.
+ *
+ * The URL defaults to the centralized `APIS_BASE_URL` gateway with the
+ * `/v1/platform/projects` path prefix.
+ *
+ * Example:
+ * ```ts
+ * const projects = createProjectsClient({ auth });
+ * const all = await projects.list();
+ * ```
+ */
+export const createProjectsClient = (params) => {
+    const baseUrl = (params.url ?? resolveDiskdGatewayUrl('platform/projects')).replace(/\/+$/, '');
+    const request = async (method, path, opts = {}) => {
+        const authHeaders = await resolveAuthHeaders(params.auth);
+        return httpRequest({
+            method,
+            url: `${baseUrl}${path}`,
+            authHeaders,
+            body: opts.body,
+        }, 'Projects');
+    };
+    const encId = (id) => encodeURIComponent(id);
+    return {
+        list: async () => {
+            return request('GET', '/api/projects');
+        },
+        get: async (projectId) => {
+            return request('GET', `/api/projects/${encId(projectId)}`);
+        },
+        create: async (createParams) => {
+            return request('POST', '/api/projects', {
+                body: createParams,
+            });
+        },
+        update: async (projectId, updateParams) => {
+            return request('PUT', `/api/projects/${encId(projectId)}`, {
+                body: updateParams,
+            });
+        },
+        delete: async (projectId) => {
+            await request('DELETE', `/api/projects/${encId(projectId)}`);
+        },
+    };
+};
+//# sourceMappingURL=projects.js.map

package/dist/projects/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/projects/projects.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAmB,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AASlF,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAGpC,EAAkB,EAAE;IACnB,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,sBAAsB,CAAC,mBAAmB,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEhG,MAAM,OAAO,GAAG,KAAK,EACnB,MAAkB,EAClB,IAAY,EACZ,OAAoC,EAAE,EAC1B,EAAE;QACd,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1D,OAAO,WAAW,CAChB;YACE,MAAM;YACN,GAAG,EAAE,GAAG,OAAO,GAAG,IAAI,EAAE;YACxB,WAAW;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,EACD,UAAU,CACX,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,CAAC,EAAU,EAAU,EAAE,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAE7D,OAAO;QACL,IAAI,EAAE,KAAK,IAAiC,EAAE;YAC5C,OAAO,OAAO,CAAqB,KAAK,EAAE,eAAe,CAAC,CAAC;QAC7D,CAAC;QAED,GAAG,EAAE,KAAK,EAAE,SAAiB,EAA4B,EAAE;YACzD,OAAO,OAAO,CAAkB,KAAK,EAAE,iBAAiB,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,YAAiC,EAAoB,EAAE;YACpE,OAAO,OAAO,CAAU,MAAM,EAAE,eAAe,EAAE;gBAC/C,IAAI,EAAE,YAAY;aACnB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,SAAiB,EAAE,YAAiC,EAAoB,EAAE;YACvF,OAAO,OAAO,CAAU,KAAK,EAAE,iBAAiB,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE;gBAClE,IAAI,EAAE,YAAY;aACnB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,SAAiB,EAAiB,EAAE;YACjD,MAAM,OAAO,CAAU,QAAQ,EAAE,iBAAiB,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/projects/projectsTypes.d.ts

@@ -0,0 +1,47 @@
+export type Project = {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly icon?: string;
+    readonly iconColor?: string;
+    readonly updatedAt: string;
+};
+export type ProjectDetailed = {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly icon?: string;
+    readonly iconColor?: string;
+    readonly updatedAt: string;
+};
+export type ProjectCreateParams = {
+    readonly name: string;
+    readonly description?: string;
+    readonly icon?: string;
+    readonly iconColor?: string;
+};
+export type ProjectUpdateParams = {
+    readonly name?: string;
+    readonly description?: string;
+    readonly icon?: string;
+    readonly iconColor?: string;
+};
+/**
+ * Projects REST client.
+ *
+ * Obtain via `diskd.platform.projects({ auth })`.
+ * Maps to the app-service `/api/projects` endpoints.
+ */
+export type ProjectsClient = {
+    /** GET /api/projects -- list all projects. */
+    readonly list: () => Promise<readonly Project[]>;
+    /** GET /api/projects/:projectId -- get a single project by id. */
+    readonly get: (projectId: string) => Promise<ProjectDetailed>;
+    /** POST /api/projects -- create a new project. */
+    readonly create: (params: ProjectCreateParams) => Promise<Project>;
+    /** PUT /api/projects/:projectId -- update an existing project. */
+    readonly update: (projectId: string, params: ProjectUpdateParams) => Promise<Project>;
+    /** DELETE /api/projects/:projectId -- delete a project. */
+    readonly delete: (projectId: string) => Promise<void>;
+};
+//# sourceMappingURL=projectsTypes.d.ts.map