@toznysecure/teambots-sdk 0.2.0

package/README.md

@@ -0,0 +1,156 @@
+# @toz/teambots-sdk
+
+TypeScript client and **integration contract** for partner apps (Currents, DotClinic, …).
+
+**Plan:** `docs/plans/integration-sdk-hardening-plan.md`  
+**API reference:** `docs/sdk/INTEGRATION_SDK.md`
+
+## Install
+
+```bash
+cd sdk && npm install && npm run build
+```
+
+Monorepo consumer:
+
+```json
+{ "dependencies": { "@toz/teambots-sdk": "file:../sdk" } }
+```
+
+## Quick start
+
+```typescript
+import {
+  TeamBotsClient,
+  CURRENTS_SKILL_CAPABILITY_MAP,
+  buildCapabilitiesFromManifest,
+  buildPartnerAppContext,
+  validateToolIntent,
+} from '@toz/teambots-sdk';
+
+const client = new TeamBotsClient({
+  baseUrl: 'https://api.teambots.ai/api',
+  integrationKey: process.env.TEAMBOTS_INTEGRATION_KEY!,
+  appId: 'currents',
+});
+
+const { manifest } = await client.connectAgent({
+  agentEmail: 'maya@tozlabs.teambots.ai',
+  appTenantId: companyUuid,
+  adminEmail: 'sponsor@toz.com',
+});
+
+const capabilities = buildCapabilitiesFromManifest(manifest, CURRENTS_SKILL_CAPABILITY_MAP);
+
+await client.registerManifestWebhook({
+  appTenantId: companyUuid,
+  webhookUrl: 'https://app.example.com/webhooks/teambots/manifest-updated',
+});
+
+const reply = await client.channelChat({
+  agentId: manifest.agentId,
+  appTenantId: companyUuid,
+  messages: [{ role: 'user', content: 'Create a task for sprint review' }],
+  appContext: buildPartnerAppContext({
+    appName: 'Currents',
+    manifestSkills: manifest.skills,
+    skillCapabilityMap: CURRENTS_SKILL_CAPABILITY_MAP,
+  }),
+});
+
+for (const intent of reply.toolIntents) {
+  const check = validateToolIntent(intent, manifest, CURRENTS_SKILL_CAPABILITY_MAP, capabilities);
+  if (!check.valid) continue;
+  // dispatch locally…
+  await client.reportToolExecution({
+    agentId: manifest.agentId,
+    appTenantId: companyUuid,
+    skillId: intent.skillId,
+    action: intent.action,
+    success: true,
+  });
+}
+```
+
+## Exports
+
+| Export | Purpose |
+|--------|---------|
+| `TeamBotsClient` | HTTP client (connect, manifest, chat, audit, webhook) |
+| `CURRENTS_SKILL_CAPABILITY_MAP` | Canonical 30-skill map — **do not copy** |
+| `buildCapabilitiesFromManifest` | Replace-all capability mirror |
+| `validateToolIntent` | Governance gate before local execute |
+| `buildPartnerAppContext` | Required `appContext.partner` payload |
+| `getIntentSchema` / `validateIntentData` | Intent `data` schemas |
+| `INTEGRATION_ERRORS` | Error catalog + remediation |
+
+## Version
+
+Package version `0.2.0` — echoed on `IntegrationManifest.sdkVersion` from TeamBots API.
+
+## Publishing to npm (automatic)
+
+This package publishes to **npmjs.com** when you push a git tag. No manual `npm publish` on your laptop unless you want to.
+
+### One-time setup
+
+1. **Create the SDK repo on GitHub**  
+   Move everything under `sdk/` to the new repo root (including `sdk/.github` → `.github` at repo root).
+
+2. **npm org for `@toz` scope**  
+   Log in at [npmjs.com](https://www.npmjs.com). Ensure your account (or team) owns the `@toz` scope. Scoped packages need `--access public` on first publish (the workflow already passes this).
+
+3. **Create an npm automation token**  
+   - npm → Account → **Access Tokens** → **Generate New Token**  
+   - Type: **Automation** (for CI; does not expire on 2FA session)  
+   - Permissions: publish for `@toz` (or full publish if your org requires it)  
+   - Copy the token once — you will not see it again.
+
+4. **Add the token to GitHub**  
+   - SDK repo → **Settings** → **Secrets and variables** → **Actions**  
+   - **New repository secret**  
+   - Name: `NPM_TOKEN`  
+   - Value: paste the npm automation token  
+
+5. **Update `repository.url` in `package.json`**  
+   Replace `YOUR_ORG/teambots-sdk` with your real GitHub org/repo.
+
+6. **First publish (one time, from your machine)** — only if `@toz/teambots-sdk` does not exist on npm yet:
+
+   ```bash
+   npm login
+   npm ci && npm run build
+   npm publish --access public
+   ```
+
+   After the first publish, CI handles all later releases.
+
+### Every release (automatic)
+
+```bash
+# From SDK repo root
+chmod +x scripts/release.sh
+./scripts/release.sh 0.2.1
+
+git push origin main
+git push origin v0.2.1
+```
+
+What happens:
+
+1. `release.sh` updates `package.json` and `src/version.ts` to the same version.
+2. It commits and creates tag `v0.2.1`.
+3. Pushing the tag triggers `.github/workflows/publish.yml`.
+4. GitHub Actions builds the SDK and runs `npm publish` using `NPM_TOKEN`.
+
+Install in other repos:
+
+```bash
+npm install @toz/teambots-sdk@^0.2.1
+```
+
+### Rules
+
+- Tag must match `package.json`: tag `v0.2.1` → version `0.2.1`.
+- `src/version.ts` `SDK_VERSION` must match `package.json` (CI checks this).
+- Never re-publish the same version to npm — bump the version for every release.

package/dist/client.d.ts

@@ -0,0 +1,38 @@
+import type { AgentConnectionResult, AgentLookup, ChannelChatResult, ConnectAgentInput, ConnectOrgInput, CurrentsChatInput, DotClinicTestResult, IntegrationApp, IntegrationManifest, OrgConnection, RegisterManifestWebhookInput, SyncMemoryInput, SyncMemoryResult, TeamBotsClientOptions, ToolExecutionAuditInput } from './types';
+export declare class TeamBotsApiError extends Error {
+    status: number;
+    constructor(message: string, status: number);
+}
+export declare class TeamBotsClient {
+    private baseUrl;
+    private integrationKey;
+    private appId;
+    private fetchImpl;
+    constructor(options: TeamBotsClientOptions);
+    private integrationHeaders;
+    private request;
+    listApps(): Promise<IntegrationApp[]>;
+    connectOrg(input: ConnectOrgInput): Promise<OrgConnection>;
+    lookupAgent(email: string, appTenantId?: string): Promise<AgentLookup>;
+    connectAgent(input: ConnectAgentInput): Promise<AgentConnectionResult>;
+    getManifest(agentId: string, opts?: {
+        organizationId?: string;
+        appTenantId?: string;
+    }): Promise<IntegrationManifest>;
+    syncMemory(agentId: string, input: SyncMemoryInput, opts?: {
+        organizationId?: string;
+        appTenantId?: string;
+    }): Promise<SyncMemoryResult>;
+    currentsChat(input: CurrentsChatInput): Promise<ChannelChatResult>;
+    /** Alias for app-specific channel routes (Currents today; DotClinic future). */
+    channelChat(input: CurrentsChatInput): Promise<ChannelChatResult>;
+    reportToolExecution(input: ToolExecutionAuditInput): Promise<{
+        recorded: boolean;
+    }>;
+    registerManifestWebhook(input: RegisterManifestWebhookInput): Promise<{
+        registered: boolean;
+    }>;
+    /** Human-auth endpoint — requires Bearer or x-user-id on fetchImpl override. */
+    testDotClinic(practice: string, userHeaders?: Record<string, string>): Promise<DotClinicTestResult>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,4BAA4B,EAC5B,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AASjB,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,MAAM,EAAE,MAAM,CAAC;gBAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAK5C;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAe;gBAEpB,OAAO,EAAE,qBAAqB;IAO1C,OAAO,CAAC,kBAAkB;YAQZ,OAAO;IAsBf,QAAQ,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIrC,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC;IAO1D,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAMtE,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAOtE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAQpH,UAAU,CACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,eAAe,EACtB,IAAI,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACvD,OAAO,CAAC,gBAAgB,CAAC;IAWtB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOxE,gFAAgF;IAC1E,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIjE,mBAAmB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAOnF,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;IAOpG,gFAAgF;IAC1E,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAa9G"}

package/dist/client.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TeamBotsClient = exports.TeamBotsApiError = void 0;
+const errors_1 = require("./errors");
+class TeamBotsApiError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.name = 'TeamBotsApiError';
+        this.status = status;
+    }
+}
+exports.TeamBotsApiError = TeamBotsApiError;
+class TeamBotsClient {
+    baseUrl;
+    integrationKey;
+    appId;
+    fetchImpl;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/$/, '');
+        this.integrationKey = options.integrationKey;
+        this.appId = options.appId;
+        this.fetchImpl = options.fetchImpl ?? fetch;
+    }
+    integrationHeaders() {
+        return {
+            'Content-Type': 'application/json',
+            'x-integration-key': this.integrationKey,
+            'x-app-id': this.appId,
+        };
+    }
+    async request(path, init = {}) {
+        const headers = new Headers(init.headers);
+        for (const [key, value] of Object.entries(this.integrationHeaders())) {
+            if (!headers.has(key))
+                headers.set(key, value);
+        }
+        const response = await this.fetchImpl(`${this.baseUrl}${path}`, {
+            ...init,
+            headers,
+        });
+        const text = await response.text();
+        const body = text ? JSON.parse(text) : null;
+        if (!response.ok || !body?.success) {
+            const info = (0, errors_1.integrationErrorForStatus)(response.status, body?.error);
+            throw new TeamBotsApiError(info.message, response.status);
+        }
+        return body.data;
+    }
+    async listApps() {
+        return this.request('/integrations/apps');
+    }
+    async connectOrg(input) {
+        return this.request('/integrations/orgs/connect', {
+            method: 'POST',
+            body: JSON.stringify(input),
+        });
+    }
+    async lookupAgent(email, appTenantId) {
+        const params = new URLSearchParams({ email });
+        if (appTenantId)
+            params.set('appTenantId', appTenantId);
+        return this.request(`/integrations/agents/lookup?${params}`);
+    }
+    async connectAgent(input) {
+        return this.request('/integrations/agents/connect', {
+            method: 'POST',
+            body: JSON.stringify(input),
+        });
+    }
+    async getManifest(agentId, opts) {
+        const params = new URLSearchParams();
+        if (opts?.organizationId)
+            params.set('organizationId', opts.organizationId);
+        if (opts?.appTenantId)
+            params.set('appTenantId', opts.appTenantId);
+        const qs = params.toString() ? `?${params}` : '';
+        return this.request(`/integrations/agents/${agentId}/manifest${qs}`);
+    }
+    async syncMemory(agentId, input, opts) {
+        const params = new URLSearchParams();
+        if (opts?.organizationId)
+            params.set('organizationId', opts.organizationId);
+        if (opts?.appTenantId)
+            params.set('appTenantId', opts.appTenantId);
+        const qs = params.toString() ? `?${params}` : '';
+        return this.request(`/integrations/agents/${agentId}/memories/sync${qs}`, {
+            method: 'POST',
+            body: JSON.stringify(input),
+        });
+    }
+    async currentsChat(input) {
+        return this.request('/integrations/channels/currents/chat', {
+            method: 'POST',
+            body: JSON.stringify(input),
+        });
+    }
+    /** Alias for app-specific channel routes (Currents today; DotClinic future). */
+    async channelChat(input) {
+        return this.currentsChat(input);
+    }
+    async reportToolExecution(input) {
+        return this.request('/integrations/audit/tool-execution', {
+            method: 'POST',
+            body: JSON.stringify(input),
+        });
+    }
+    async registerManifestWebhook(input) {
+        return this.request('/integrations/webhooks/manifest', {
+            method: 'POST',
+            body: JSON.stringify(input),
+        });
+    }
+    /** Human-auth endpoint — requires Bearer or x-user-id on fetchImpl override. */
+    async testDotClinic(practice, userHeaders = {}) {
+        const headers = { ...this.integrationHeaders(), ...userHeaders };
+        const response = await this.fetchImpl(`${this.baseUrl}/integrations/dotclinic/test`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({ practice }),
+        });
+        const body = await response.json();
+        if (!response.ok) {
+            throw new TeamBotsApiError(body?.error || 'DotClinic test failed', response.status);
+        }
+        return body.data;
+    }
+}
+exports.TeamBotsClient = TeamBotsClient;

package/dist/currents/intentSchemas.d.ts

@@ -0,0 +1,19 @@
+export type JsonSchema = {
+    type?: string | string[];
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    enum?: unknown[];
+    description?: string;
+    additionalProperties?: boolean;
+};
+export declare const CURRENTS_INTENT_SCHEMAS: Record<string, JsonSchema>;
+/** Resolve JSON Schema for a TeamBots skill id via capability map. */
+export declare function getIntentSchema(skillId: string): JsonSchema | undefined;
+/** Resolve JSON Schema by partner capability / dispatchTool action name. */
+export declare function getIntentSchemaByAction(action: string): JsonSchema | undefined;
+/** Minimal required-field check (not full JSON Schema validation). */
+export declare function validateIntentData(action: string, data: Record<string, unknown> | undefined): {
+    valid: boolean;
+    missing?: string[];
+};
+//# sourceMappingURL=intentSchemas.d.ts.map

package/dist/currents/intentSchemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intentSchemas.d.ts","sourceRoot":"","sources":["../../src/currents/intentSchemas.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAKF,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAqF9D,CAAC;AAEF,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAIvE;AAED,4EAA4E;AAC5E,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE9E;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACxC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CASxC"}

package/dist/currents/intentSchemas.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CURRENTS_INTENT_SCHEMAS = void 0;
+exports.getIntentSchema = getIntentSchema;
+exports.getIntentSchemaByAction = getIntentSchemaByAction;
+exports.validateIntentData = validateIntentData;
+/**
+ * JSON Schema (draft-07 subset) for Currents tool intent `data` payloads.
+ * @see docs/integrations/CURRENTS_CAPABILITY_MAP.md
+ */
+const skillMap_1 = require("./skillMap");
+const PRIORITY = { type: 'string', enum: ['low', 'medium', 'high', 'critical'] };
+const CARD_TYPE = { type: 'string', enum: ['task', 'idea'] };
+exports.CURRENTS_INTENT_SCHEMAS = {
+    create_cards: {
+        type: 'object',
+        required: ['title'],
+        properties: {
+            title: { type: 'string', description: 'Card title' },
+            description: { type: 'string' },
+            type: CARD_TYPE,
+            project_id: { type: 'string' },
+            assignee_id: { type: 'string' },
+            assignee_name: { type: 'string', description: '"you" | "me" | display name' },
+            priority: PRIORITY,
+            due_date: { type: 'string', description: 'ISO date YYYY-MM-DD' },
+            status: { type: 'string' },
+            team_id: { type: 'string' },
+            team_name: { type: 'string' },
+            sprint_id: { type: 'string' },
+            sprint_name: { type: 'string' },
+            roadmap_id: { type: 'string' },
+            parent_id: { type: 'string' },
+        },
+        additionalProperties: true,
+    },
+    update_cards: {
+        type: 'object',
+        properties: {
+            cardId: { type: 'string' },
+            id: { type: 'string' },
+            title: { type: 'string' },
+            description: { type: 'string' },
+            type: CARD_TYPE,
+            assignee_id: { type: 'string' },
+            assignee_name: { type: 'string' },
+            priority: PRIORITY,
+            due_date: { type: 'string' },
+            status: { type: 'string' },
+            team_id: { type: 'string' },
+            team_name: { type: 'string' },
+            sprint_id: { type: 'string' },
+            sprint_name: { type: 'string' },
+            roadmap_id: { type: 'string' },
+            url: { type: 'string', description: 'attach_artifact' },
+        },
+        additionalProperties: true,
+    },
+    delete_cards: {
+        type: 'object',
+        properties: {
+            cardId: { type: 'string' },
+            id: { type: 'string' },
+            title: { type: 'string' },
+        },
+        additionalProperties: true,
+    },
+    search_cards: {
+        type: 'object',
+        properties: {
+            title: { type: 'string' },
+            type: CARD_TYPE,
+            query: { type: 'string' },
+        },
+        additionalProperties: true,
+    },
+    create_sprints: {
+        type: 'object',
+        required: ['name'],
+        properties: {
+            name: { type: 'string' },
+            description: { type: 'string' },
+            status: { type: 'string' },
+            start_date: { type: 'string' },
+            end_date: { type: 'string' },
+            project_id: { type: 'string' },
+            project_name: { type: 'string' },
+        },
+        additionalProperties: true,
+    },
+    link_card_to_sprint_by_name: {
+        type: 'object',
+        properties: {
+            card_title: { type: 'string' },
+            sprint_name: { type: 'string' },
+        },
+        additionalProperties: true,
+    },
+};
+/** Resolve JSON Schema for a TeamBots skill id via capability map. */
+function getIntentSchema(skillId) {
+    const action = skillMap_1.CURRENTS_SKILL_CAPABILITY_MAP[skillId];
+    if (!action)
+        return undefined;
+    return exports.CURRENTS_INTENT_SCHEMAS[action];
+}
+/** Resolve JSON Schema by partner capability / dispatchTool action name. */
+function getIntentSchemaByAction(action) {
+    return exports.CURRENTS_INTENT_SCHEMAS[action];
+}
+/** Minimal required-field check (not full JSON Schema validation). */
+function validateIntentData(action, data) {
+    const schema = exports.CURRENTS_INTENT_SCHEMAS[action];
+    if (!schema?.required?.length)
+        return { valid: true };
+    const payload = data ?? {};
+    const missing = schema.required.filter((key) => {
+        const v = payload[key];
+        return v === undefined || v === null || v === '';
+    });
+    return missing.length === 0 ? { valid: true } : { valid: false, missing };
+}

package/dist/currents/skillMap.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Canonical Currents skill id → capability key (dispatchTool name).
+ * Single source of truth — import from @toz/teambots-sdk; do not copy.
+ * @see docs/integrations/CURRENTS_CAPABILITY_MAP.md
+ */
+export declare const CURRENTS_SKILL_CAPABILITY_MAP: Record<string, string>;
+export declare const CURRENTS_FEDERABLE_SKILL_IDS: string[];
+//# sourceMappingURL=skillMap.d.ts.map

package/dist/currents/skillMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillMap.d.ts","sourceRoot":"","sources":["../../src/currents/skillMap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA+BhE,CAAC;AAEF,eAAO,MAAM,4BAA4B,UAA6C,CAAC"}

package/dist/currents/skillMap.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CURRENTS_FEDERABLE_SKILL_IDS = exports.CURRENTS_SKILL_CAPABILITY_MAP = void 0;
+/**
+ * Canonical Currents skill id → capability key (dispatchTool name).
+ * Single source of truth — import from @toz/teambots-sdk; do not copy.
+ * @see docs/integrations/CURRENTS_CAPABILITY_MAP.md
+ */
+exports.CURRENTS_SKILL_CAPABILITY_MAP = {
+    'currents.create_task': 'create_cards',
+    'currents.update_task': 'update_cards',
+    'currents.delete_task': 'delete_cards',
+    'currents.post_status': 'update_cards',
+    'currents.attach_artifact': 'update_cards',
+    'currents.request_approval': 'update_cards',
+    'currents.search_tasks': 'search_cards',
+    'currents.create_sprint': 'create_sprints',
+    'currents.update_sprint': 'update_sprints',
+    'currents.delete_sprint': 'delete_sprints',
+    'currents.search_sprints': 'search_sprints',
+    'currents.create_roadmap': 'create_roadmaps',
+    'currents.update_roadmap': 'update_roadmaps',
+    'currents.delete_roadmap': 'delete_roadmaps',
+    'currents.search_roadmaps': 'search_roadmaps',
+    'currents.create_requirement': 'create_requirements',
+    'currents.update_requirement': 'update_requirements',
+    'currents.delete_requirement': 'delete_requirements',
+    'currents.search_requirements': 'search_requirements',
+    'currents.create_project': 'create_projects',
+    'currents.update_project': 'update_projects',
+    'currents.delete_project': 'delete_projects',
+    'currents.create_plan': 'create_plans',
+    'currents.update_plan': 'update_plans',
+    'currents.delete_plan': 'delete_plans',
+    'currents.search_teams': 'search_teams',
+    'currents.search_users': 'search_users',
+    'currents.share_item': 'share_item',
+    'currents.link_github_issue': 'link_github_issue',
+    'currents.link_card_to_sprint': 'link_card_to_sprint_by_name',
+};
+exports.CURRENTS_FEDERABLE_SKILL_IDS = Object.keys(exports.CURRENTS_SKILL_CAPABILITY_MAP);

package/dist/errors.d.ts

@@ -0,0 +1,10 @@
+/** Partner-facing integration error catalog with remediation hints. */
+export interface IntegrationErrorInfo {
+    httpStatus: number;
+    code: string;
+    message: string;
+    remediation: string;
+}
+export declare const INTEGRATION_ERRORS: Record<string, IntegrationErrorInfo>;
+export declare function integrationErrorForStatus(status: number, fallbackMessage?: string): IntegrationErrorInfo;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAiDnE,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,oBAAoB,CASxG"}

package/dist/errors.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INTEGRATION_ERRORS = void 0;
+exports.integrationErrorForStatus = integrationErrorForStatus;
+exports.INTEGRATION_ERRORS = {
+    AUTH_MISSING_KEY: {
+        httpStatus: 401,
+        code: 'AUTH_MISSING_KEY',
+        message: 'Missing or invalid x-integration-key',
+        remediation: 'Generate an org-scoped key in TeamBots → Integrations and set x-integration-key + x-app-id headers.',
+    },
+    AUTH_FORBIDDEN_ORG: {
+        httpStatus: 403,
+        code: 'AUTH_FORBIDDEN_ORG',
+        message: 'Integration key cannot access this organization',
+        remediation: 'Use a key scoped to the same TeamBots org as the agent or tenant.',
+    },
+    ORG_NOT_CONNECTED: {
+        httpStatus: 404,
+        code: 'ORG_NOT_CONNECTED',
+        message: 'App tenant is not connected to a TeamBots organization',
+        remediation: 'Call POST /integrations/orgs/connect with teambotsOrgId and appTenantId.',
+    },
+    AGENT_NOT_FOUND: {
+        httpStatus: 404,
+        code: 'AGENT_NOT_FOUND',
+        message: 'Agent not found for email or id',
+        remediation: 'Verify agent email, org connection, and that the agent status is active or paused.',
+    },
+    AGENT_NOT_CONNECTED: {
+        httpStatus: 409,
+        code: 'AGENT_NOT_CONNECTED',
+        message: 'Agent is not connected to this partner app',
+        remediation: 'Call POST /integrations/agents/connect before manifest or chat requests.',
+    },
+    DOMAIN_NOT_VERIFIED: {
+        httpStatus: 409,
+        code: 'DOMAIN_NOT_VERIFIED',
+        message: 'Admin email domain is not verified for org connection',
+        remediation: 'Add the admin email domain to verifiedDomains on org connect.',
+    },
+    BUDGET_EXCEEDED: {
+        httpStatus: 402,
+        code: 'BUDGET_EXCEEDED',
+        message: 'Agent or org LLM budget exceeded',
+        remediation: 'Increase agent budget in TeamBots or wait for billing period reset.',
+    },
+    MANIFEST_STALE: {
+        httpStatus: 409,
+        code: 'MANIFEST_STALE',
+        message: 'Local capabilities do not match manifest runtimeConfigVersion',
+        remediation: 'Refresh manifest from TeamBots or handle manifest-updated webhook.',
+    },
+};
+function integrationErrorForStatus(status, fallbackMessage) {
+    const match = Object.values(exports.INTEGRATION_ERRORS).find((e) => e.httpStatus === status);
+    if (match)
+        return match;
+    return {
+        httpStatus: status,
+        code: 'UNKNOWN',
+        message: fallbackMessage ?? `Request failed (${status})`,
+        remediation: 'Check TeamBots API logs and docs/sdk/INTEGRATION_SDK.md error catalog.',
+    };
+}

package/dist/helpers/capabilities.d.ts

@@ -0,0 +1,11 @@
+import type { IntegrationManifest, ManifestSkill } from '../types';
+export type CapabilityMirror = Record<string, boolean>;
+/**
+ * Build a full capability mirror from manifest — **replace-all**, never merge.
+ * Every key in skillCapabilityMap gets true/false based on manifest.skills[].
+ */
+export declare function buildCapabilitiesFromManifest(manifest: IntegrationManifest, skillCapabilityMap: Record<string, string>): CapabilityMirror;
+export declare function manifestSkillIds(manifest: IntegrationManifest): Set<string>;
+export declare function manifestCapabilityKeys(manifest: IntegrationManifest): Set<string>;
+export declare function findManifestSkill(manifest: IntegrationManifest, skillId: string): ManifestSkill | undefined;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/helpers/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/helpers/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAc,MAAM,UAAU,CAAC;AAE/E,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,mBAAmB,EAC7B,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACzC,gBAAgB,CAUlB;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,GAAG,CAAC,MAAM,CAAC,CAE3E;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,GAAG,CAAC,MAAM,CAAC,CAIjF;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE3G"}

package/dist/helpers/capabilities.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCapabilitiesFromManifest = buildCapabilitiesFromManifest;
+exports.manifestSkillIds = manifestSkillIds;
+exports.manifestCapabilityKeys = manifestCapabilityKeys;
+exports.findManifestSkill = findManifestSkill;
+/**
+ * Build a full capability mirror from manifest — **replace-all**, never merge.
+ * Every key in skillCapabilityMap gets true/false based on manifest.skills[].
+ */
+function buildCapabilitiesFromManifest(manifest, skillCapabilityMap) {
+    const enabled = new Set(manifest.skills.map((s) => s.appCapabilityKey ?? skillCapabilityMap[s.id]).filter(Boolean));
+    const mirror = {};
+    for (const capabilityKey of Object.values(skillCapabilityMap)) {
+        mirror[capabilityKey] = enabled.has(capabilityKey);
+    }
+    return mirror;
+}
+function manifestSkillIds(manifest) {
+    return new Set(manifest.skills.map((s) => s.id));
+}
+function manifestCapabilityKeys(manifest) {
+    return new Set(manifest.skills.map((s) => s.appCapabilityKey).filter((k) => Boolean(k)));
+}
+function findManifestSkill(manifest, skillId) {
+    return manifest.skills.find((s) => s.id === skillId);
+}

package/dist/helpers/partnerContext.d.ts

@@ -0,0 +1,31 @@
+export interface PartnerSkillContext {
+    skillId: string;
+    capabilityKey: string;
+    label: string;
+}
+export interface PartnerAppContext {
+    app: string;
+    enabledCapabilityKeys: string[];
+    enabledSkills: PartnerSkillContext[];
+    senderId?: string;
+    senderDisplayName?: string;
+}
+/**
+ * Build appContext.partner payload for channel chat (required for federated agents).
+ */
+export declare function buildPartnerAppContext(input: {
+    appName: string;
+    manifestSkills: Array<{
+        id: string;
+        name: string;
+        appCapabilityKey?: string;
+    }>;
+    skillCapabilityMap: Record<string, string>;
+    senderId?: string;
+    senderDisplayName?: string;
+}): {
+    partner: PartnerAppContext;
+};
+/** Merge partner context into an existing appContext object. */
+export declare function withPartnerAppContext(appContext: Record<string, unknown> | undefined, partner: PartnerAppContext): Record<string, unknown>;
+//# sourceMappingURL=partnerContext.d.ts.map

package/dist/helpers/partnerContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"partnerContext.d.ts","sourceRoot":"","sources":["../../src/helpers/partnerContext.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/E,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG;IAAE,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAgBjC;AAED,gEAAgE;AAChE,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC/C,OAAO,EAAE,iBAAiB,GACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB"}

package/dist/helpers/partnerContext.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPartnerAppContext = buildPartnerAppContext;
+exports.withPartnerAppContext = withPartnerAppContext;
+/**
+ * Build appContext.partner payload for channel chat (required for federated agents).
+ */
+function buildPartnerAppContext(input) {
+    const enabledSkills = input.manifestSkills.map((s) => ({
+        skillId: s.id,
+        capabilityKey: s.appCapabilityKey ?? input.skillCapabilityMap[s.id] ?? s.id,
+        label: s.name,
+    }));
+    return {
+        partner: {
+            app: input.appName,
+            enabledCapabilityKeys: enabledSkills.map((s) => s.capabilityKey),
+            enabledSkills,
+            senderId: input.senderId,
+            senderDisplayName: input.senderDisplayName,
+        },
+    };
+}
+/** Merge partner context into an existing appContext object. */
+function withPartnerAppContext(appContext, partner) {
+    return { ...appContext, partner };
+}

package/dist/helpers/validateToolIntent.d.ts

@@ -0,0 +1,14 @@
+import type { IntegrationManifest, ToolIntent } from '../types';
+export interface ValidateToolIntentResult {
+    valid: boolean;
+    reason?: string;
+}
+/**
+ * Validate a tool intent against manifest governance rules.
+ *
+ * - skillId must appear in manifest.skills[]
+ * - action must match manifest skill appCapabilityKey (or skillCapabilityMap fallback)
+ * - optional localCapabilities gate (partner-side mirror)
+ */
+export declare function validateToolIntent(intent: ToolIntent, manifest: IntegrationManifest, skillCapabilityMap: Record<string, string>, localCapabilities?: Record<string, boolean>): ValidateToolIntentResult;
+//# sourceMappingURL=validateToolIntent.d.ts.map

package/dist/helpers/validateToolIntent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateToolIntent.d.ts","sourceRoot":"","sources":["../../src/helpers/validateToolIntent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGhE,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,mBAAmB,EAC7B,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,wBAAwB,CAuB1B"}

package/dist/helpers/validateToolIntent.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateToolIntent = validateToolIntent;
+const capabilities_1 = require("./capabilities");
+/**
+ * Validate a tool intent against manifest governance rules.
+ *
+ * - skillId must appear in manifest.skills[]
+ * - action must match manifest skill appCapabilityKey (or skillCapabilityMap fallback)
+ * - optional localCapabilities gate (partner-side mirror)
+ */
+function validateToolIntent(intent, manifest, skillCapabilityMap, localCapabilities) {
+    const skill = (0, capabilities_1.findManifestSkill)(manifest, intent.skillId);
+    if (!skill) {
+        return { valid: false, reason: `Skill "${intent.skillId}" is not in manifest` };
+    }
+    const expectedAction = skill.appCapabilityKey ?? skillCapabilityMap[intent.skillId];
+    if (!expectedAction) {
+        return { valid: false, reason: `No capability mapping for skill "${intent.skillId}"` };
+    }
+    if (intent.action !== expectedAction) {
+        return {
+            valid: false,
+            reason: `action "${intent.action}" does not match expected "${expectedAction}" for skill "${intent.skillId}"`,
+        };
+    }
+    if (localCapabilities && localCapabilities[expectedAction] === false) {
+        return { valid: false, reason: `Capability "${expectedAction}" is disabled locally` };
+    }
+    return { valid: true };
+}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export { SDK_VERSION } from './version';
+export { TeamBotsClient, TeamBotsApiError } from './client';
+export type { TeamBotsClientOptions, ConnectOrgInput, ConnectAgentInput, CurrentsChatInput, IntegrationApp, AgentLookup, IntegrationManifest, ManifestSkill, ManifestLlmRouting, ManifestSponsorNotificationCategory, ManifestSponsorNotifications, AgentConnectionResult, ChannelChatResult, ToolIntent, OrgConnection, DotClinicTestResult, ToolExecutionAuditInput, ManifestUpdatedWebhookPayload, RegisterManifestWebhookInput, SyncMemoryInput, SyncMemoryResult, } from './types';
+export { CURRENTS_SKILL_CAPABILITY_MAP, CURRENTS_FEDERABLE_SKILL_IDS, } from './currents/skillMap';
+export { CURRENTS_INTENT_SCHEMAS, getIntentSchema, getIntentSchemaByAction, validateIntentData, } from './currents/intentSchemas';
+export type { JsonSchema } from './currents/intentSchemas';
+export { buildCapabilitiesFromManifest, manifestSkillIds, manifestCapabilityKeys, findManifestSkill, } from './helpers/capabilities';
+export type { CapabilityMirror } from './helpers/capabilities';
+export { validateToolIntent } from './helpers/validateToolIntent';
+export type { ValidateToolIntentResult } from './helpers/validateToolIntent';
+export { buildPartnerAppContext, withPartnerAppContext, } from './helpers/partnerContext';
+export type { PartnerAppContext, PartnerSkillContext } from './helpers/partnerContext';
+export { INTEGRATION_ERRORS, integrationErrorForStatus } from './errors';
+export type { IntegrationErrorInfo } from './errors';
+/** @deprecated Use TeamBotsClient — alias for docs that say createIntegrationClient */
+export declare function createIntegrationClient(options: import('./types').TeamBotsClientOptions): TeamBotsClient;
+import { TeamBotsClient } from './client';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5D,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,mCAAmC,EACnC,4BAA4B,EAC5B,qBAAqB,EACrB,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,6BAA6B,EAC7B,4BAA4B,EAC5B,eAAe,EACf,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,EACL,6BAA6B,EAC7B,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,YAAY,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAE7E,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEvF,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AACzE,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD,uFAAuF;AACvF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,SAAS,EAAE,qBAAqB,GAAG,cAAc,CAExG;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.integrationErrorForStatus = exports.INTEGRATION_ERRORS = exports.withPartnerAppContext = exports.buildPartnerAppContext = exports.validateToolIntent = exports.findManifestSkill = exports.manifestCapabilityKeys = exports.manifestSkillIds = exports.buildCapabilitiesFromManifest = exports.validateIntentData = exports.getIntentSchemaByAction = exports.getIntentSchema = exports.CURRENTS_INTENT_SCHEMAS = exports.CURRENTS_FEDERABLE_SKILL_IDS = exports.CURRENTS_SKILL_CAPABILITY_MAP = exports.TeamBotsApiError = exports.TeamBotsClient = exports.SDK_VERSION = void 0;
+exports.createIntegrationClient = createIntegrationClient;
+var version_1 = require("./version");
+Object.defineProperty(exports, "SDK_VERSION", { enumerable: true, get: function () { return version_1.SDK_VERSION; } });
+var client_1 = require("./client");
+Object.defineProperty(exports, "TeamBotsClient", { enumerable: true, get: function () { return client_1.TeamBotsClient; } });
+Object.defineProperty(exports, "TeamBotsApiError", { enumerable: true, get: function () { return client_1.TeamBotsApiError; } });
+var skillMap_1 = require("./currents/skillMap");
+Object.defineProperty(exports, "CURRENTS_SKILL_CAPABILITY_MAP", { enumerable: true, get: function () { return skillMap_1.CURRENTS_SKILL_CAPABILITY_MAP; } });
+Object.defineProperty(exports, "CURRENTS_FEDERABLE_SKILL_IDS", { enumerable: true, get: function () { return skillMap_1.CURRENTS_FEDERABLE_SKILL_IDS; } });
+var intentSchemas_1 = require("./currents/intentSchemas");
+Object.defineProperty(exports, "CURRENTS_INTENT_SCHEMAS", { enumerable: true, get: function () { return intentSchemas_1.CURRENTS_INTENT_SCHEMAS; } });
+Object.defineProperty(exports, "getIntentSchema", { enumerable: true, get: function () { return intentSchemas_1.getIntentSchema; } });
+Object.defineProperty(exports, "getIntentSchemaByAction", { enumerable: true, get: function () { return intentSchemas_1.getIntentSchemaByAction; } });
+Object.defineProperty(exports, "validateIntentData", { enumerable: true, get: function () { return intentSchemas_1.validateIntentData; } });
+var capabilities_1 = require("./helpers/capabilities");
+Object.defineProperty(exports, "buildCapabilitiesFromManifest", { enumerable: true, get: function () { return capabilities_1.buildCapabilitiesFromManifest; } });
+Object.defineProperty(exports, "manifestSkillIds", { enumerable: true, get: function () { return capabilities_1.manifestSkillIds; } });
+Object.defineProperty(exports, "manifestCapabilityKeys", { enumerable: true, get: function () { return capabilities_1.manifestCapabilityKeys; } });
+Object.defineProperty(exports, "findManifestSkill", { enumerable: true, get: function () { return capabilities_1.findManifestSkill; } });
+var validateToolIntent_1 = require("./helpers/validateToolIntent");
+Object.defineProperty(exports, "validateToolIntent", { enumerable: true, get: function () { return validateToolIntent_1.validateToolIntent; } });
+var partnerContext_1 = require("./helpers/partnerContext");
+Object.defineProperty(exports, "buildPartnerAppContext", { enumerable: true, get: function () { return partnerContext_1.buildPartnerAppContext; } });
+Object.defineProperty(exports, "withPartnerAppContext", { enumerable: true, get: function () { return partnerContext_1.withPartnerAppContext; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "INTEGRATION_ERRORS", { enumerable: true, get: function () { return errors_1.INTEGRATION_ERRORS; } });
+Object.defineProperty(exports, "integrationErrorForStatus", { enumerable: true, get: function () { return errors_1.integrationErrorForStatus; } });
+/** @deprecated Use TeamBotsClient — alias for docs that say createIntegrationClient */
+function createIntegrationClient(options) {
+    return new client_2.TeamBotsClient(options);
+}
+const client_2 = require("./client");

package/dist/types.d.ts

@@ -0,0 +1,215 @@
+export interface TeamBotsClientOptions {
+    baseUrl: string;
+    integrationKey: string;
+    appId: string;
+    fetchImpl?: typeof fetch;
+}
+export interface IntegrationApp {
+    id: string;
+    name: string;
+    description: string;
+    docsUrl?: string;
+    active: boolean;
+}
+export interface OrgConnection {
+    id: string;
+    organizationId: string;
+    appId: string;
+    appTenantId: string;
+    status: string;
+    verifiedDomains: string[];
+    connectedAt?: string;
+}
+export interface AgentLookup {
+    agentId: string;
+    name: string;
+    emailIdentity: string;
+    status: string;
+    organizationId: string;
+    organizationSlug: string;
+    organizationName: string;
+    humanSponsor: string;
+    avatar: {
+        initials: string;
+        tint: string;
+        imageUrl?: string;
+    };
+    jobTitle: string;
+    department: string;
+    jobFunction: string;
+    starterProfileSlug: string;
+    profileName?: string;
+    jobDescription?: string;
+    canConnect: boolean;
+}
+export interface ManifestSkill {
+    id: string;
+    name: string;
+    toolId: string;
+    risk: string;
+    requiresApproval: boolean;
+    appCapabilityKey?: string;
+}
+export interface ManifestLlmRouting {
+    provider: 'teambots_gateway';
+    gatewayMode: 'mock' | 'live';
+    channelActivityType: 'channel_message';
+}
+export interface ManifestSponsorNotificationCategory {
+    id: string;
+    label: string;
+    description: string;
+    defaultChannels: {
+        inApp: boolean;
+        email: boolean;
+    };
+    mirrorInPartnerUi: boolean;
+    partnerAlertPriority: 'low' | 'normal' | 'high';
+}
+export interface ManifestSponsorNotifications {
+    preferencesUrl: string;
+    leadSponsorUserId?: string;
+    categories: ManifestSponsorNotificationCategory[];
+}
+export interface IntegrationManifest {
+    agentId: string;
+    name: string;
+    emailIdentity: string;
+    status: string;
+    organizationId: string;
+    organizationSlug: string;
+    organizationName: string;
+    humanSponsor: string;
+    avatar: {
+        initials: string;
+        tint: string;
+        imageUrl?: string;
+    };
+    jobTitle: string;
+    department: string;
+    jobFunction: string;
+    starterProfileSlug: string;
+    profileName?: string;
+    jobDescription?: string;
+    /** Brain used for partner in-app DM (channel_message activity). */
+    defaultBrainId: string;
+    defaultBrainDisplayName: string;
+    llmRouting: ManifestLlmRouting;
+    skills: ManifestSkill[];
+    enabledToolIds: string[];
+    enabledMcpServerIds: string[];
+    runtimeConfigVersion: number;
+    /** Monotonic connection sync counter (increments on skill/brain changes). */
+    manifestVersion?: number;
+    /** ISO timestamp of last manifest sync (partner refresh or connect). */
+    lastSyncAt?: string;
+    /** Published @toz/teambots-sdk version when manifest was built. */
+    sdkVersion?: string;
+    /** Where partner channel chat inference runs — gateway fallback when desktop is stopped. */
+    partnerAgentRoutingMode?: 'teambots_gateway' | 'openclaw_runtime';
+    /** Kasm connect URL when cloud desktop is live — partners open beside channel chat. */
+    desktopSessionUrl?: string;
+    /** Sponsor notification categories — partners may mirror alerts for users who live in their app. */
+    sponsorNotifications?: ManifestSponsorNotifications;
+    connectionStatus?: string;
+    connectedAt?: string;
+    appLocalAgentId?: string;
+}
+export interface AgentConnectionResult {
+    connection: {
+        id: string;
+        agentId: string;
+        appId: string;
+        appLocalAgentId?: string;
+        status: string;
+        connectedAt?: string;
+    };
+    manifest: IntegrationManifest;
+}
+export interface ToolIntent {
+    skillId: string;
+    action: string;
+    data?: Record<string, unknown>;
+}
+export interface ChannelChatResult {
+    content: string;
+    brainId: string;
+    brainDisplayName: string;
+    gatewayMode: 'mock' | 'live';
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        costUsd: number;
+    };
+    toolIntents: ToolIntent[];
+}
+export interface ConnectOrgInput {
+    teambotsOrgId: string;
+    appTenantId: string;
+    adminEmail: string;
+    verifiedDomains?: string[];
+}
+export interface ConnectAgentInput {
+    agentEmail: string;
+    appTenantId: string;
+    adminEmail: string;
+    appLocalAgentId?: string;
+}
+export interface CurrentsChatInput {
+    agentId: string;
+    appTenantId: string;
+    messages: Array<{
+        role: string;
+        content: string;
+    }>;
+    activityType?: string;
+    appContext?: Record<string, unknown>;
+}
+export interface DotClinicTestResult {
+    reachable: boolean;
+    practice: string;
+    agentContext: unknown;
+    contextError: string | null;
+}
+export interface ToolExecutionAuditInput {
+    agentId: string;
+    appTenantId: string;
+    skillId: string;
+    action: string;
+    success: boolean;
+    message?: string;
+    data?: Record<string, unknown>;
+}
+export interface ManifestUpdatedWebhookPayload {
+    event: 'manifest.updated';
+    agentId: string;
+    appTenantId: string;
+    appId: string;
+    runtimeConfigVersion: number;
+    manifestVersion: number;
+    occurredAt: string;
+}
+export interface RegisterManifestWebhookInput {
+    appTenantId: string;
+    webhookUrl: string;
+}
+export type PartnerMemorySyncTarget = 'memory' | 'training' | 'custom';
+export interface SyncMemoryInput {
+    target?: PartnerMemorySyncTarget;
+    /** Training slot when target=training: ORG, ROLE, etc. */
+    slot?: string;
+    /** Custom slug when target=custom */
+    customSlug?: string;
+    type?: string;
+    title: string;
+    content: string;
+    scope?: 'local' | 'org';
+    approved?: boolean;
+    approvedByName?: string;
+    appendToTraining?: boolean;
+}
+export interface SyncMemoryResult {
+    target: PartnerMemorySyncTarget;
+    result: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+/** Published SDK version — echoed on IntegrationManifest.sdkVersion. */
+export declare const SDK_VERSION = "0.2.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,eAAO,MAAM,WAAW,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SDK_VERSION = void 0;
+/** Published SDK version — echoed on IntegrationManifest.sdkVersion. */
+exports.SDK_VERSION = '0.2.0';

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@toznysecure/teambots-sdk",
+  "version": "0.2.0",
+  "description": "TeamBots Integration SDK — connect hired agents to partner apps",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tozny/teambots-sdk.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.js"
+    },
+    "./currents/skillMap": {
+      "types": "./dist/currents/skillMap.d.ts",
+      "require": "./dist/currents/skillMap.js",
+      "import": "./dist/currents/skillMap.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3"
+  }
+}