@taskclan/sdk 1.0.0

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) Taskclan. All rights reserved.
+
+This software and its source code are proprietary and confidential. No license,
+express or implied, is granted to use, copy, modify, distribute, or sublicense
+this software except as explicitly authorized in writing by Taskclan. It is
+intended for use only within Taskclan products and by parties Taskclan has
+authorized.

package/README.md

@@ -0,0 +1,70 @@
+# @taskclan/sdk
+
+The typed client for the **Taskclan Taskclan** — the L3 agentic layer. Built on
+[`@taskclan/platform`](../hive-sdk-ts), it adds the agent / skill / memory surface
+so any product can:
+
+- **`runAgent`** — run a named agent's capability (dispatch one of its Hive intents)
+- **`runSkill`** — run a named skill's capability
+- **`remember` / `recall` / `listMemories` / `forget`** — read & write shared memory
+- **`listAgents` / `getAgent` / `listSkills` / `listWorkflows`** — discover the registry
+
+It reuses the platform client's transport, so everything goes through Hive's one
+endpoint (`POST /api/hive/v1/intent`). You also get `client.platform` for events,
+entitlements, identity, and roles.
+
+## Install
+
+Published privately to **GitHub Packages** under the `taskclan` org. Point the
+`@taskclan` scope at GitHub's registry (one line covers both `@taskclan/platform`
+and `@taskclan/sdk`) and authenticate with a `read:packages` token:
+
+```ini
+# .npmrc (in the consuming repo)
+@taskclan:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
+```
+
+```bash
+npm install @taskclan/sdk
+```
+
+## Usage
+
+```ts
+import { createTaskclanClient } from '@taskclan/sdk';
+
+const hive = createTaskclanClient({
+  baseUrl: 'https://engine.taskclan.com',
+  product: 'nani',
+  getToken: () => supabase.auth.getSession().then((s) => s.data.session?.access_token ?? null),
+});
+
+// Discover an agent's intents, then run one
+const { agents } = await hive.listAgents();
+const creator = agents.find((a) => a.id === 'gamenova-creator');
+if (creator) {
+  const result = await hive.runAgent(creator.id, creator.intents[0], { /* input */ });
+}
+
+// Shared memory (household-scoped family vault)
+await hive.remember({ householdId, type: 'allergy', key: 'peanuts', value: 'severe' });
+const { memories } = await hive.listMemories({ householdId, type: 'allergy' });
+
+// Escape hatch + the full platform client
+await hive.platform.trackEvent('nani.household_created');
+```
+
+Pass `{ validate: true }` to `runAgent` / `runSkill` to first check (against the
+public registry) that the intent really belongs to that agent/skill.
+
+## Publishing
+
+Bump `version` in `package.json`, then push a tag:
+
+```bash
+git tag taskclan-sdk-v1.0.0 && git push origin taskclan-sdk-v1.0.0
+```
+
+The **Publish @taskclan/sdk** GitHub Action builds and publishes to GitHub
+Packages using the built-in `GITHUB_TOKEN` — no secret to configure.

package/dist/client.d.ts

@@ -0,0 +1,66 @@
+/**
+ * createTaskclanClient — the typed client for the Taskclan Taskclan (L3).
+ *
+ * It wraps a @taskclan/platform client (the shared Hive transport) and layers
+ * the agentic surface on top: run named agents and skills, read/write shared
+ * memory, and discover the registries. `client.platform` exposes the underlying
+ * platform client for events, entitlements, identity, and roles.
+ */
+import { type PlatformClient } from '@taskclan/platform';
+import type { TaskclanClientConfig, DispatchOptions, AgentsRegistry, SkillsRegistry, WorkflowsRegistry, HiveAgent, FamilyMemory, RememberInput, RecallInput, ListMemoriesInput, RecallInsightsInput, TaskclanInsight } from './types';
+/** Per-run options (everything `dispatchIntent` takes, plus an opt-in check). */
+export interface RunOptions extends DispatchOptions {
+    /** Verify the intent is one the agent/skill actually exposes (one extra registry call). */
+    validate?: boolean;
+}
+export interface TaskclanClient {
+    /** Run a named agent's capability — dispatch `intent` (one of the agent's intents) through Hive. */
+    runAgent<T = unknown>(agentId: string, intent: string, input?: unknown, opts?: RunOptions): Promise<T>;
+    /** Run a named skill's capability — dispatch `intent` (one the skill exercises) through Hive. */
+    runSkill<T = unknown>(skillId: string, intent: string, input?: unknown, opts?: RunOptions): Promise<T>;
+    /** Discovery — the named agents (public registry). */
+    listAgents(): Promise<AgentsRegistry>;
+    /** A single agent by id from the registry (null if unknown). */
+    getAgent(agentId: string): Promise<HiveAgent | null>;
+    /** Discovery — the named skills/capabilities. */
+    listSkills(): Promise<SkillsRegistry>;
+    /** Discovery — the cross-product workflows. */
+    listWorkflows(): Promise<WorkflowsRegistry>;
+    /** Store or update a shared (family) memory. */
+    remember(input: RememberInput): Promise<{
+        memory: FamilyMemory;
+    }>;
+    /** Read a memory by id, or look it up by type (+ optional key). */
+    recall<T = {
+        memory: FamilyMemory | null;
+    }>(input: RecallInput): Promise<T>;
+    /** List memories, optionally filtered by child and/or type. */
+    listMemories<T = {
+        memories: FamilyMemory[];
+    }>(input: ListMemoriesInput): Promise<T>;
+    /** Delete a memory by id. */
+    forget<T = unknown>(input: {
+        householdId: string;
+        id: string;
+    }): Promise<T>;
+    /** Ask the Taskclan what it has LEARNED that applies to you (cross-product insights). */
+    recallInsights<T = {
+        product: string;
+        count: number;
+        insights: TaskclanInsight[];
+    }>(input?: RecallInsightsInput): Promise<T>;
+    /** Get insight-driven behavioral defaults to apply before acting (agent improvement). */
+    recommendDefaults<T = {
+        product: string;
+        defaults: Record<string, string>;
+        basedOn: unknown[];
+    }>(input?: {
+        product?: string;
+    }): Promise<T>;
+    /** Escape hatch — dispatch any Hive intent directly. */
+    dispatchIntent: PlatformClient['dispatchIntent'];
+    /** The underlying platform client (events, entitlements, identity, roles). */
+    platform: PlatformClient;
+}
+export declare function createTaskclanClient(config: TaskclanClientConfig): TaskclanClient;
+//# 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;;;;;;;GAOG;AAEH,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE/E,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,iFAAiF;AACjF,MAAM,WAAW,UAAW,SAAQ,eAAe;IACjD,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,oGAAoG;IACpG,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvG,iGAAiG;IACjG,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvG,sDAAsD;IACtD,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IACtC,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACrD,iDAAiD;IACjD,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IACtC,+CAA+C;IAC/C,aAAa,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC5C,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC;IAClE,mEAAmE;IACnE,MAAM,CAAC,CAAC,GAAG;QAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;KAAE,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5E,+DAA+D;IAC/D,YAAY,CAAC,CAAC,GAAG;QAAE,QAAQ,EAAE,YAAY,EAAE,CAAA;KAAE,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACrF,6BAA6B;IAC7B,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5E,yFAAyF;IACzF,cAAc,CAAC,CAAC,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,eAAe,EAAE,CAAA;KAAE,EAAE,KAAK,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7H,yFAAyF;IACzF,iBAAiB,CAAC,CAAC,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,OAAO,EAAE,OAAO,EAAE,CAAA;KAAE,EAAE,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3I,wDAAwD;IACxD,cAAc,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAC;IACjD,8EAA8E;IAC9E,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAqHjF"}

package/dist/client.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * createTaskclanClient — the typed client for the Taskclan Taskclan (L3).
+ *
+ * It wraps a @taskclan/platform client (the shared Hive transport) and layers
+ * the agentic surface on top: run named agents and skills, read/write shared
+ * memory, and discover the registries. `client.platform` exposes the underlying
+ * platform client for events, entitlements, identity, and roles.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTaskclanClient = createTaskclanClient;
+const platform_1 = require("@taskclan/platform");
+function createTaskclanClient(config) {
+    const platform = (0, platform_1.createPlatformClient)(config);
+    async function assertExposes(kind, id, intent) {
+        if (kind === 'agent') {
+            const reg = await platform.listAgents();
+            const a = reg.agents.find((x) => x.id === id);
+            if (!a)
+                throw new Error(`[taskclan] unknown agent "${id}"`);
+            if (!a.intents.includes(intent))
+                throw new Error(`[taskclan] agent "${id}" does not expose intent "${intent}"`);
+        }
+        else {
+            const reg = await platform.listSkills();
+            const s = reg.skills.find((x) => x.id === id);
+            if (!s)
+                throw new Error(`[taskclan] unknown skill "${id}"`);
+            if (!s.intents.includes(intent))
+                throw new Error(`[taskclan] skill "${id}" does not exercise intent "${intent}"`);
+        }
+    }
+    async function runAgent(agentId, intent, input = {}, opts = {}) {
+        if (opts.validate)
+            await assertExposes('agent', agentId, intent);
+        return platform.dispatchIntent(intent, input, {
+            ...opts,
+            context: { ...(opts.context ?? {}), agent: agentId },
+        });
+    }
+    async function runSkill(skillId, intent, input = {}, opts = {}) {
+        if (opts.validate)
+            await assertExposes('skill', skillId, intent);
+        return platform.dispatchIntent(intent, input, {
+            ...opts,
+            context: { ...(opts.context ?? {}), skill: skillId },
+        });
+    }
+    async function getAgent(agentId) {
+        const reg = await platform.listAgents();
+        return reg.agents.find((a) => a.id === agentId) ?? null;
+    }
+    function remember(input) {
+        return platform.dispatchIntent('memory.write', {
+            child_id: input.childId ?? null,
+            memory_type: input.type,
+            memory_key: input.key,
+            memory_value: input.value,
+            ...(input.source ? { source: input.source } : {}),
+        }, { householdId: input.householdId });
+    }
+    function recall(input) {
+        const body = input.id
+            ? { id: input.id }
+            : { child_id: input.childId ?? null, memory_type: input.type, ...(input.key ? { memory_key: input.key } : {}) };
+        return platform.dispatchIntent('memory.read', body, { householdId: input.householdId });
+    }
+    function listMemories(input) {
+        return platform.dispatchIntent('memory.list', {
+            ...(input.childId !== undefined ? { child_id: input.childId } : {}),
+            ...(input.type ? { memory_type: input.type } : {}),
+        }, { householdId: input.householdId });
+    }
+    function forget(input) {
+        return platform.dispatchIntent('memory.delete', { id: input.id }, { householdId: input.householdId });
+    }
+    /**
+     * recallInsights — ask the Taskclan what it has LEARNED that applies to you.
+     * Returns active, cross-product insights (with recommended_action) that other
+     * products may have taught. Aggregate knowledge only; never raw user data.
+     */
+    function recallInsights(input = {}) {
+        return platform.dispatchIntent('hivemind.insights.query', {
+            ...(input.product ? { product: input.product } : {}),
+            ...(input.insightType ? { insight_type: input.insightType } : {}),
+            ...(input.minConfidence != null ? { min_confidence: input.minConfidence } : {}),
+            ...(input.limit != null ? { limit: input.limit } : {}),
+        });
+    }
+    /**
+     * recommendDefaults — distilled behavioral defaults from active insights (incl.
+     * ones OTHER products taught). Call before acting, then apply the returned
+     * defaults — e.g. GameNova gets `asset.poly_mode:'low'` because Forge3D learned it.
+     */
+    function recommendDefaults(input = {}) {
+        return platform.dispatchIntent('hivemind.recommend_defaults', input.product ? { product: input.product } : {});
+    }
+    return {
+        runAgent,
+        runSkill,
+        listAgents: platform.listAgents,
+        getAgent,
+        listSkills: platform.listSkills,
+        listWorkflows: platform.listWorkflows,
+        remember,
+        recall,
+        listMemories,
+        forget,
+        recallInsights,
+        recommendDefaults,
+        dispatchIntent: platform.dispatchIntent,
+        platform,
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { createTaskclanClient } from './client';
+export type { TaskclanClient, RunOptions } from './client';
+export { PlatformError } from '@taskclan/platform';
+export type { TaskclanClientConfig, DispatchOptions, MemoryType, MemorySource, FamilyMemory, RememberInput, RecallInput, ListMemoriesInput, HiveAgent, HiveSkill, HiveWorkflow, HiveWorkflowStep, AgentsRegistry, SkillsRegistry, WorkflowsRegistry, } from './types';
+/** @deprecated Renamed to `createTaskclanClient`. */
+export { createTaskclanClient as createHivemindClient } from './client';
+/** @deprecated Renamed to `TaskclanClient`. */
+export type { TaskclanClient as HivemindClient } from './client';
+/** @deprecated Renamed to `TaskclanClientConfig`. */
+export type { TaskclanClientConfig as HivemindClientConfig } from './types';
+//# 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,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,qDAAqD;AACrD,OAAO,EAAE,oBAAoB,IAAI,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACxE,+CAA+C;AAC/C,YAAY,EAAE,cAAc,IAAI,cAAc,EAAE,MAAM,UAAU,CAAC;AACjE,qDAAqD;AACrD,YAAY,EAAE,oBAAoB,IAAI,oBAAoB,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createHivemindClient = exports.PlatformError = exports.createTaskclanClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "createTaskclanClient", { enumerable: true, get: function () { return client_1.createTaskclanClient; } });
+// Re-export the platform error class so consumers can `instanceof PlatformError`
+// without also importing @taskclan/platform directly.
+var platform_1 = require("@taskclan/platform");
+Object.defineProperty(exports, "PlatformError", { enumerable: true, get: function () { return platform_1.PlatformError; } });
+// --- Deprecated aliases (pre-1.0 "Hivemind" names) — remove in a future major. ---
+/** @deprecated Renamed to `createTaskclanClient`. */
+var client_2 = require("./client");
+Object.defineProperty(exports, "createHivemindClient", { enumerable: true, get: function () { return client_2.createTaskclanClient; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAgD;AAAvC,8GAAA,oBAAoB,OAAA;AAE7B,iFAAiF;AACjF,sDAAsD;AACtD,+CAAmD;AAA1C,yGAAA,aAAa,OAAA;AAmBtB,oFAAoF;AACpF,qDAAqD;AACrD,mCAAwE;AAA/D,8GAAA,oBAAoB,OAAwB"}

package/dist/types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Shared types for the @taskclan/sdk client.
+ *
+ * Taskclan (L3) sits on top of @taskclan/platform (L2): the config and the
+ * discovery types are the platform's, re-exported here so consumers import
+ * everything from one place. The memory types model the family-memory vault
+ * the `memory.*` intents read and write today.
+ */
+import type { PlatformClientConfig } from '@taskclan/platform';
+/** Same config you pass to the platform client (baseUrl, product, getToken, …). */
+export type TaskclanClientConfig = PlatformClientConfig;
+export type { DispatchOptions, HiveAgent, HiveSkill, HiveWorkflow, HiveWorkflowStep, AgentsRegistry, SkillsRegistry, WorkflowsRegistry, } from '@taskclan/platform';
+export type MemoryType = 'allergy' | 'medication' | 'clothing_size' | 'shoe_size' | 'favourite_food' | 'disliked_food' | 'doctor' | 'school' | 'teacher' | 'activity' | 'emergency_contact' | 'insurance' | 'pickup_authorization' | 'custom';
+export type MemorySource = 'manual' | 'voice' | 'school_email' | 'system';
+/** A stored memory row (the shape `memory.*` intents return). */
+export interface FamilyMemory {
+    id: string;
+    household_id: string;
+    child_id: string | null;
+    memory_type: MemoryType;
+    memory_key: string;
+    memory_value: string;
+    source: MemorySource;
+    created_at: string;
+    updated_at: string;
+}
+export interface RememberInput {
+    /** Household the memory belongs to (memory.* are household-scoped). */
+    householdId: string;
+    type: MemoryType;
+    key: string;
+    value: string;
+    /** Null/omit for household-level facts; a child's uuid for child-specific ones. */
+    childId?: string | null;
+    source?: MemorySource;
+}
+export interface RecallInput {
+    householdId: string;
+    /** Read one memory directly by id … */
+    id?: string;
+    /** … or look it up by type (+ optional key). */
+    type?: MemoryType;
+    key?: string;
+    childId?: string | null;
+}
+export interface ListMemoriesInput {
+    householdId: string;
+    type?: MemoryType;
+    childId?: string | null;
+}
+/** Input for recallInsights() — ask the Taskclan what it has learned for you. */
+export interface RecallInsightsInput {
+    /** Defaults to the client's product. Returns insights that apply to it. */
+    product?: string;
+    insightType?: string;
+    minConfidence?: number;
+    limit?: number;
+}
+/** A learned, cross-product pattern. Aggregate only — never raw user data. */
+export interface TaskclanInsight {
+    id: string;
+    source_product: string;
+    insight_type: string;
+    title: string;
+    description: string | null;
+    confidence: number;
+    evidence: Record<string, unknown>;
+    recommended_action: Record<string, unknown>;
+    applies_to: string[];
+    status: string;
+    sample_size: number;
+    computed_at: string;
+}
+//# 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":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,mFAAmF;AACnF,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAExD,YAAY,EACV,eAAe,EACf,SAAS,EACT,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAI5B,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,YAAY,GACZ,eAAe,GACf,WAAW,GACX,gBAAgB,GAChB,eAAe,GACf,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,UAAU,GACV,mBAAmB,GACnB,WAAW,GACX,sBAAsB,GACtB,QAAQ,CAAC;AAEb,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,cAAc,GAAG,QAAQ,CAAC;AAE1E,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,UAAU,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,iFAAiF;AACjF,MAAM,WAAW,mBAAmB;IAClC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/types.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Shared types for the @taskclan/sdk client.
+ *
+ * Taskclan (L3) sits on top of @taskclan/platform (L2): the config and the
+ * discovery types are the platform's, re-exported here so consumers import
+ * everything from one place. The memory types model the family-memory vault
+ * the `memory.*` intents read and write today.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@taskclan/sdk",
+  "version": "1.0.0",
+  "description": "Typed client for the Taskclan Taskclan (L3 agentic layer) — run named agents and skills, read/write shared memory, recall cross-product insights + insight-driven defaults (the learning loop), and discover the agent/skill/workflow registries. Built on @taskclan/platform.",
+  "license": "UNLICENSED",
+  "author": "Taskclan",
+  "private": false,
+  "publishConfig": { "access": "public" },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/taskclan/taskclan-monorepo.git",
+    "directory": "packages/taskclan-sdk"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "taskclan",
+    "taskclan",
+    "agents",
+    "memory",
+    "skills"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@taskclan/platform": "^0.2.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.4"
+  }
+}