@taskclan/sdk 1.0.0 → 1.1.0

package/README.md

@@ -1,6 +1,48 @@
 # @taskclan/sdk
 
-The typed client for the **Taskclan Taskclan** — the L3 agentic layer. Built on
+The typed client for **Taskclan Intelligence**.
+
+## Quickstart — the T1 client
+
+Run a goal against the metered T1 API. The `t1-flow` profile picks the model,
+tools, and reasoning depth for you (`t1-core` for fast/high-volume, `t1-max` for
+deep reasoning). Spend debits your key's credit wallet.
+
+```ts
+import { Taskclan } from "@taskclan/sdk";
+
+const taskclan = new Taskclan({ apiKey: process.env.TASKCLAN_API_KEY });
+
+const result = await taskclan.run({
+  profile: "t1-flow",
+  goal: "Draft a friendly reply to this review",
+  input: { text: "The app is great but sign-in is slow." },
+});
+
+console.log(result.output);
+```
+
+The API key comes from `TASKCLAN_API_KEY` when not passed. Create one in the
+console at [`/t1`](https://engine.taskclan.com/t1) (Developer API keys). The
+default profile can also be set on the client: `new Taskclan({ profile: "t1-flow" })`.
+
+### Stream
+
+```ts
+const stream = await taskclan.run.stream({ profile: "t1-flow", goal: "Explain vector databases" });
+for await (const event of stream) {
+  if (event.type === "text") process.stdout.write(event.delta);
+}
+```
+
+`run.stream` yields `{ type: "text", delta }` per token, then a final
+`{ type: "done", creditsCharged, balance, model }`.
+
+---
+
+## The L3 agentic layer
+
+The rest of this client is the **Taskclan L3 agentic layer**. Built on
 [`@taskclan/platform`](../hive-sdk-ts), it adds the agent / skill / memory surface
 so any product can:
 

package/dist/engine.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Taskclan Engine — deterministic workflows over the T1 primitives.
+ *
+ * A workflow is an ordered set of steps run CLIENT-SIDE by the SDK: each step
+ * calls a real metered surface (step.run → /api/t1/complete, step.generate →
+ * /api/t1/studio, step.evaluate → an LLM-judge run) or a local tool, threading
+ * one step's output into the next and gating side-effecting steps on evaluation.
+ * "Deterministic structure around adaptive intelligence" — the structure is the
+ * ordered, conditional step graph; the intelligence is the T1 calls inside it.
+ */
+import type { RunInput, RunResult, StudioNamespace, ToolDefinition, T1Profile } from './t1';
+/** What the engine needs from a Taskclan client (the real client satisfies this). */
+export interface EngineClient {
+    run(input: RunInput): Promise<RunResult>;
+    studio: StudioNamespace;
+}
+export type WorkflowStep = {
+    kind: 'run';
+    id: string;
+    goal: string;
+    profile?: T1Profile;
+    tools?: ToolDefinition[];
+} | {
+    kind: 'generate';
+    id: string;
+    modality?: 'image' | 'video' | 'audio' | 'threeD';
+    /** Static prompt … */
+    prompt?: string;
+    /** … or use another step's text output as the prompt. */
+    promptFrom?: string;
+    size?: string;
+    quality?: 'low' | 'medium' | 'high';
+} | {
+    kind: 'evaluate';
+    id: string;
+    /** Step whose output to judge (default: the most recent text output). */
+    from?: string;
+    quality?: boolean;
+    policy?: string[];
+    rights?: boolean;
+    /** A custom business check, in plain language. */
+    outcome?: string;
+} | {
+    kind: 'tool';
+    id: string;
+    tool: ToolDefinition;
+    /** Gate: `"stepId.field"` (e.g. "check.passed"); optional leading `!`. */
+    when?: string;
+    /** Args for the tool; defaults to `{ input, steps }` (the workflow context). */
+    args?: Record<string, unknown>;
+};
+export interface Workflow {
+    name: string;
+    steps: WorkflowStep[];
+}
+/** Define a workflow. Pass it to `taskclan.engine.run(workflow, { input })`. */
+export declare function workflow(def: {
+    name: string;
+    steps: WorkflowStep[];
+}): Workflow;
+type StepInput<K extends WorkflowStep['kind']> = Omit<Extract<WorkflowStep, {
+    kind: K;
+}>, 'kind'>;
+/** Typed step constructors. */
+export declare const step: {
+    run: (o: StepInput<"run">) => WorkflowStep;
+    generate: (o: StepInput<"generate">) => WorkflowStep;
+    evaluate: (o: StepInput<"evaluate">) => WorkflowStep;
+    tool: (o: StepInput<"tool">) => WorkflowStep;
+};
+export interface StepResult {
+    id: string;
+    type: WorkflowStep['kind'];
+    /** Text output (run / tool). */
+    output?: string;
+    /** Hosted asset URL (generate). */
+    url?: string;
+    /** Whether an evaluate gate passed. */
+    passed?: boolean;
+    /** Structured payload (tool return, evaluate verdict, generated asset id). */
+    data?: unknown;
+    /** True when a `when:` gate skipped this step. */
+    skipped?: boolean;
+    error?: string;
+}
+export interface EngineRunOptions {
+    /** Structured input every step can reference (goals see it; tools get it as context). */
+    input?: Record<string, unknown>;
+}
+export interface EngineRunResult {
+    status: 'completed' | 'failed';
+    /** Results keyed by step id — e.g. `run.steps.publish.output`. */
+    steps: Record<string, StepResult>;
+    /** The step that failed, if status is 'failed'. */
+    failedStep?: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    /** Total credits across every metered step. */
+    creditsCharged: number;
+    /** Wallet balance after the run. */
+    balance: number;
+}
+/** taskclan.engine — deterministic workflow execution. */
+export interface EngineNamespace {
+    run(wf: Workflow, opts?: EngineRunOptions): Promise<EngineRunResult>;
+}
+export declare function createEngine(client: EngineClient): EngineNamespace;
+export {};
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

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

package/dist/engine.js

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * Taskclan Engine — deterministic workflows over the T1 primitives.
+ *
+ * A workflow is an ordered set of steps run CLIENT-SIDE by the SDK: each step
+ * calls a real metered surface (step.run → /api/t1/complete, step.generate →
+ * /api/t1/studio, step.evaluate → an LLM-judge run) or a local tool, threading
+ * one step's output into the next and gating side-effecting steps on evaluation.
+ * "Deterministic structure around adaptive intelligence" — the structure is the
+ * ordered, conditional step graph; the intelligence is the T1 calls inside it.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.step = void 0;
+exports.workflow = workflow;
+exports.createEngine = createEngine;
+/** Define a workflow. Pass it to `taskclan.engine.run(workflow, { input })`. */
+function workflow(def) {
+    return { name: def.name, steps: def.steps };
+}
+/** Typed step constructors. */
+exports.step = {
+    run: (o) => ({ kind: 'run', ...o }),
+    generate: (o) => ({ kind: 'generate', ...o }),
+    evaluate: (o) => ({ kind: 'evaluate', ...o }),
+    tool: (o) => ({ kind: 'tool', ...o }),
+};
+function createEngine(client) {
+    return { run: (wf, opts) => runWorkflow(client, wf, opts) };
+}
+// ── internals ────────────────────────────────────────────────────────────────
+/** Resolve a `when:` gate like "check.passed" (optional leading "!") against results. */
+function resolveWhen(expr, steps) {
+    let e = expr.trim();
+    let negate = false;
+    if (e.startsWith('!')) {
+        negate = true;
+        e = e.slice(1).trim();
+    }
+    const [id, field = 'passed'] = e.split('.');
+    const truthy = Boolean(steps[id]?.[field]);
+    return negate ? !truthy : truthy;
+}
+/** The most recent step that produced text output (for evaluate's default target). */
+function lastOutput(order, steps) {
+    for (let i = order.length - 1; i >= 0; i--) {
+        const r = steps[order[i]];
+        if (r?.output)
+            return r.output;
+    }
+    return undefined;
+}
+function buildJudgePrompt(target, checks) {
+    return [
+        'You are a strict evaluation gate in a workflow. Assess the CONTENT below against every check.',
+        `Checks: ${checks.join('; ') || 'general quality'}.`,
+        '',
+        'CONTENT:',
+        target && target.trim() ? target : '(no content was produced)',
+        '',
+        'Respond with ONLY a JSON object: {"passed": boolean, "reason": "one sentence"}.',
+        '"passed" is true only if the content satisfies ALL checks.',
+    ].join('\n');
+}
+function parseVerdict(text) {
+    const m = text.match(/\{[\s\S]*\}/);
+    if (m) {
+        try {
+            const j = JSON.parse(m[0]);
+            return { passed: j.passed === true, reason: typeof j.reason === 'string' ? j.reason : '' };
+        }
+        catch {
+            /* fall through */
+        }
+    }
+    return { passed: /"?passed"?\s*[:=]\s*true/i.test(text), reason: '' };
+}
+async function runWorkflow(client, wf, opts) {
+    const input = opts?.input ?? {};
+    const steps = {};
+    const order = [];
+    let inTok = 0;
+    let outTok = 0;
+    let credits = 0;
+    let balance = 0;
+    const acc = (r) => {
+        inTok += r.usage?.inputTokens ?? 0;
+        outTok += r.usage?.outputTokens ?? 0;
+        credits += r.creditsCharged ?? 0;
+        if (typeof r.balance === 'number')
+            balance = r.balance;
+    };
+    for (const s of wf.steps) {
+        order.push(s.id);
+        // Conditional gate (tool steps).
+        if (s.kind === 'tool' && s.when && !resolveWhen(s.when, steps)) {
+            steps[s.id] = { id: s.id, type: 'tool', skipped: true };
+            continue;
+        }
+        try {
+            if (s.kind === 'run') {
+                const r = await client.run({ goal: s.goal, input, profile: s.profile, tools: s.tools });
+                acc(r);
+                steps[s.id] = { id: s.id, type: 'run', output: r.output, data: r.steps };
+            }
+            else if (s.kind === 'generate') {
+                const prompt = s.prompt ?? (s.promptFrom ? String(steps[s.promptFrom]?.output ?? '') : '');
+                const asset = await client.studio.generate({ modality: s.modality ?? 'image', prompt, size: s.size, quality: s.quality });
+                acc(asset);
+                steps[s.id] = { id: s.id, type: 'generate', url: asset.url, data: { assetId: asset.id } };
+            }
+            else if (s.kind === 'evaluate') {
+                const target = s.from ? steps[s.from]?.output : lastOutput(order.slice(0, -1), steps);
+                const checks = [
+                    ...(s.quality ? ['quality: meets a quality bar for the task'] : []),
+                    ...(s.policy ?? []).map((p) => `policy: complies with the "${p}" policy`),
+                    ...(s.rights ? ['rights: generated media is safe to use'] : []),
+                    ...(s.outcome ? [`outcome: ${s.outcome}`] : []),
+                ];
+                const judge = await client.run({ goal: buildJudgePrompt(target, checks), profile: 't1-core' });
+                acc(judge);
+                const verdict = parseVerdict(judge.output);
+                steps[s.id] = { id: s.id, type: 'evaluate', passed: verdict.passed, data: verdict };
+            }
+            else if (s.kind === 'tool') {
+                const args = s.args ?? { input, steps: mapOutputs(steps) };
+                const out = await s.tool.run(args);
+                steps[s.id] = { id: s.id, type: 'tool', output: typeof out === 'string' ? out : JSON.stringify(out), data: out };
+            }
+        }
+        catch (e) {
+            steps[s.id] = { id: s.id, type: s.kind, error: e.message };
+            return { status: 'failed', steps, failedStep: s.id, usage: { inputTokens: inTok, outputTokens: outTok }, creditsCharged: credits, balance };
+        }
+    }
+    return { status: 'completed', steps, usage: { inputTokens: inTok, outputTokens: outTok }, creditsCharged: credits, balance };
+}
+/** A compact { stepId: output } map handed to tool steps as context. */
+function mapOutputs(steps) {
+    const out = {};
+    for (const [id, r] of Object.entries(steps))
+        out[id] = r.output ?? r.url ?? r.data ?? null;
+    return out;
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAkDH,4BAEC;AAmDD,oCAEC;AAxDD,gFAAgF;AAChF,SAAgB,QAAQ,CAAC,GAA4C;IACnE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;AAC9C,CAAC;AAID,+BAA+B;AAClB,QAAA,IAAI,GAAG;IAClB,GAAG,EAAE,CAAC,CAAmB,EAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;IACnE,QAAQ,EAAE,CAAC,CAAwB,EAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,CAAC;IAClF,QAAQ,EAAE,CAAC,CAAwB,EAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,CAAC;IAClF,IAAI,EAAE,CAAC,CAAoB,EAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;CACvE,CAAC;AAyCF,SAAgB,YAAY,CAAC,MAAoB;IAC/C,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED,gFAAgF;AAEhF,yFAAyF;AACzF,SAAS,WAAW,CAAC,IAAY,EAAE,KAAiC;IAClE,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACpB,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAAC,MAAM,GAAG,IAAI,CAAC;QAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAAC,CAAC;IAChE,MAAM,CAAC,EAAE,EAAE,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAE,KAAK,CAAC,EAAE,CAAoD,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/F,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;AACnC,CAAC;AAED,sFAAsF;AACtF,SAAS,UAAU,CAAC,KAAe,EAAE,KAAiC;IACpE,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,EAAE,MAAM;YAAE,OAAO,CAAC,CAAC,MAAM,CAAC;IACjC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,gBAAgB,CAAC,MAA0B,EAAE,MAAgB;IACpE,OAAO;QACL,+FAA+F;QAC/F,WAAW,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,iBAAiB,GAAG;QACpD,EAAE;QACF,UAAU;QACV,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,2BAA2B;QAC9D,EAAE;QACF,iFAAiF;QACjF,4DAA4D;KAC7D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACpC,IAAI,CAAC,EAAE,CAAC;QACN,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAA2C,CAAC;YACrE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,KAAK,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC7F,CAAC;QAAC,MAAM,CAAC;YACP,kBAAkB;QACpB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AACxE,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,MAAoB,EAAE,EAAY,EAAE,IAAuB;IACpF,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;IAChC,MAAM,KAAK,GAA+B,EAAE,CAAC;IAC7C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,MAAM,GAAG,GAAG,CAAC,CAAyG,EAAE,EAAE;QACxH,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC,CAAC;QACnC,MAAM,IAAI,CAAC,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC;QACjC,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;YAAE,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;IACzD,CAAC,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAEjB,iCAAiC;QACjC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;YAC/D,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACxD,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBACrB,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;gBACxF,GAAG,CAAC,CAAC,CAAC,CAAC;gBACP,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YAC3E,CAAC;iBAAM,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBACjC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC3F,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC1H,GAAG,CAAC,KAAK,CAAC,CAAC;gBACX,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC;YAC5F,CAAC;iBAAM,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBACjC,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;gBACtF,MAAM,MAAM,GAAG;oBACb,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,2CAA2C,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBACnE,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,8BAA8B,CAAC,UAAU,CAAC;oBACzE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,wCAAwC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC/D,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;iBAChD,CAAC;gBACF,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;gBAC/F,GAAG,CAAC,KAAK,CAAC,CAAC;gBACX,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC3C,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YACtF,CAAC;iBAAM,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC7B,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3D,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACnC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;YACnH,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAG,CAAW,CAAC,OAAO,EAAE,CAAC;YACtE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAC9I,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC/H,CAAC;AAED,wEAAwE;AACxE,SAAS,UAAU,CAAC,KAAiC;IACnD,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC;IAC3F,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,7 @@
+export { Taskclan, TaskclanError, tool } from './t1';
+export { workflow, step, createEngine } from './engine';
+export type { Workflow, WorkflowStep, EngineClient, EngineNamespace, EngineRunOptions, EngineRunResult, StepResult, } from './engine';
+export type { TaskclanConfig, RunInput, RunResult, RunStreamEvent, RunFn, T1Profile, ToolDefinition, ZodLike, StepTrace, TaskclanErrorType, StudioAsset, StudioGenerateInput, StudioEditInput, StudioNamespace, } from './t1';
 export { createTaskclanClient } from './client';
 export type { TaskclanClient, RunOptions } from './client';
 export { PlatformError } from '@taskclan/platform';

package/dist/index.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxD,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,UAAU,GACX,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,cAAc,EACd,QAAQ,EACR,SAAS,EACT,cAAc,EACd,KAAK,EACL,SAAS,EACT,cAAc,EACd,OAAO,EACP,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,MAAM,CAAC;AAGd,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

@@ -1,6 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createHivemindClient = exports.PlatformError = exports.createTaskclanClient = void 0;
+exports.createHivemindClient = exports.PlatformError = exports.createTaskclanClient = exports.createEngine = exports.step = exports.workflow = exports.tool = exports.TaskclanError = exports.Taskclan = void 0;
+// --- T1 developer client (the docs' `new Taskclan(...).run(...)` surface) ---
+var t1_1 = require("./t1");
+Object.defineProperty(exports, "Taskclan", { enumerable: true, get: function () { return t1_1.Taskclan; } });
+Object.defineProperty(exports, "TaskclanError", { enumerable: true, get: function () { return t1_1.TaskclanError; } });
+Object.defineProperty(exports, "tool", { enumerable: true, get: function () { return t1_1.tool; } });
+var engine_1 = require("./engine");
+Object.defineProperty(exports, "workflow", { enumerable: true, get: function () { return engine_1.workflow; } });
+Object.defineProperty(exports, "step", { enumerable: true, get: function () { return engine_1.step; } });
+Object.defineProperty(exports, "createEngine", { enumerable: true, get: function () { return engine_1.createEngine; } });
+// --- L3 agentic client (named agents/skills, memory, insights, registries) ---
 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`

package/dist/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+EAA+E;AAC/E,2BAAqD;AAA5C,8FAAA,QAAQ,OAAA;AAAE,mGAAA,aAAa,OAAA;AAAE,0FAAA,IAAI,OAAA;AACtC,mCAAwD;AAA/C,kGAAA,QAAQ,OAAA;AAAE,8FAAA,IAAI,OAAA;AAAE,sGAAA,YAAY,OAAA;AA2BrC,gFAAgF;AAChF,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/t1.d.ts

@@ -0,0 +1,237 @@
+/**
+ * Taskclan — the T1 developer client.
+ *
+ *   import { Taskclan } from "@taskclan/sdk";
+ *   const taskclan = new Taskclan({ apiKey: process.env.TASKCLAN_API_KEY });
+ *   const result = await taskclan.run({ profile: "t1-flow", goal: "…", input: {…} });
+ *   console.log(result.output);
+ *
+ * A run takes a goal (+ optional structured input) and returns a verified result.
+ * The profile picks the model/reasoning depth: t1-core (fast), t1-flow (balanced,
+ * default), t1-max (deep). Backed by the metered T1 API — spend debits the key's
+ * wallet. `run.stream(...)` yields tokens as they generate.
+ */
+import { type EngineNamespace } from './engine';
+/** A T1 profile. The t1-* slugs are canonical; core|flow|max are accepted too. */
+export type T1Profile = 't1-core' | 't1-flow' | 't1-max' | 'core' | 'flow' | 'max' | (string & {});
+export interface TaskclanConfig {
+    /** Your Taskclan API key (sk_t1_…). Defaults to process.env.TASKCLAN_API_KEY. */
+    apiKey?: string;
+    /** Default profile for runs when one isn't passed to run(). Defaults to t1-flow. */
+    profile?: T1Profile;
+    /** API base URL. Defaults to TASKCLAN_BASE_URL or https://engine.taskclan.com. */
+    baseUrl?: string;
+    /** Inject a fetch implementation (tests / non-global-fetch runtimes). */
+    fetch?: typeof fetch;
+}
+/**
+ * A Zod-like schema — structurally what `tool({ input })` accepts. Any Zod v3
+ * schema satisfies this (zod is a peer dependency; the SDK never imports it).
+ */
+export interface ZodLike<T = unknown> {
+    _def: unknown;
+    safeParse(v: unknown): {
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        error: unknown;
+    };
+}
+/** A typed tool the model may call. The handler runs on the CALLER, not the server. */
+export interface ToolDefinition<T = any> {
+    /** Unique, snake_case identifier the model calls by. */
+    name: string;
+    /** What the tool does — the model reads this to decide when to use it. */
+    description: string;
+    /** Zod schema; validates the model's arguments before your handler runs. */
+    input: ZodLike<T>;
+    /** Your handler. Return anything JSON-serializable; it's fed back to the model. */
+    run: (input: T) => Promise<unknown> | unknown;
+}
+/** Define a typed tool. Pass the returned object to `run({ tools: [...] })`. */
+export declare function tool<T = any>(def: ToolDefinition<T>): ToolDefinition<T>;
+/** A single step in a run's trace (tool calls + their results). */
+export type StepTrace = {
+    type: 'tool_call';
+    name: string;
+    input: unknown;
+} | {
+    type: 'tool_result';
+    name: string;
+    output: string;
+    isError: boolean;
+};
+export interface RunInput {
+    /** What you want done, in plain language. */
+    goal: string;
+    /** Profile override for this run (else the client default). */
+    profile?: T1Profile;
+    /** Structured context the model should use (JSON-serialized into the prompt). */
+    input?: unknown;
+    /** Extra system guidance prepended to the run. */
+    system?: string;
+    /** Cap output tokens for this run. */
+    maxTokens?: number;
+    /** Sampling temperature (0–2). */
+    temperature?: number;
+    /** Typed tools the run may call. Handlers run locally; each round-trip is metered. */
+    tools?: ToolDefinition[];
+    /** Max model turns in a tool loop before stopping (default 8). */
+    maxSteps?: number;
+    /** Reserved — the evaluation layer isn't enforced yet (accepted, no-op). */
+    verify?: boolean;
+}
+export interface RunResult {
+    /** The model's answer. */
+    output: string;
+    /** Profile that ran (resolved T1 slug). */
+    profile: string;
+    /** Underlying model. */
+    model?: string;
+    /** Aggregate token usage across every turn of the run. */
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    /** Credits this run cost (summed across tool-loop turns). */
+    creditsCharged: number;
+    /** Wallet balance after this run. */
+    balance: number;
+    finishReason?: string;
+    /** Tool calls + results, in order (present when the run used tools). */
+    steps?: StepTrace[];
+    /** True if a tool loop hit maxSteps without a final answer. */
+    maxStepsReached?: boolean;
+}
+export type RunStreamEvent = {
+    type: 'text';
+    delta: string;
+} | {
+    type: 'tool_call';
+    name: string;
+    input: unknown;
+} | {
+    type: 'tool_result';
+    name: string;
+    output: string;
+    isError: boolean;
+} | {
+    type: 'done';
+    model?: string;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    creditsCharged: number;
+    balance: number;
+    finishReason?: string;
+    steps?: StepTrace[];
+    /** Internal: set by the server on a tool turn so the stream loop can continue. */
+    toolCalls?: Array<{
+        id: string;
+        name: string;
+        input: Record<string, unknown>;
+    }>;
+} | {
+    type: 'error';
+    error: string;
+};
+/** Coarse failure class, derived from the HTTP status. */
+export type TaskclanErrorType = 'authentication' | 'insufficient_credits' | 'invalid_request' | 'rate_limit' | 'api';
+export declare class TaskclanError extends Error {
+    /** Coarse failure class (see TaskclanErrorType). */
+    readonly type: TaskclanErrorType;
+    readonly status: number;
+    readonly code?: string;
+    /** Correlate with server logs (from the X-Request-Id header / body). */
+    readonly requestId?: string;
+    /** True for transient failures (429 / 5xx) worth retrying. */
+    readonly retryable: boolean;
+    /** Wallet balance at failure time, when the API reported it (e.g. 402). */
+    readonly balance?: number;
+    constructor(message: string, status: number, code?: string, balance?: number, requestId?: string);
+}
+/** Callable run(): `taskclan.run(input)`, with `taskclan.run.stream(input)`. */
+export interface RunFn {
+    (input: RunInput): Promise<RunResult>;
+    stream(input: RunInput): Promise<AsyncIterable<RunStreamEvent>>;
+}
+/** A Studio asset — a created image with a stable id + hosted url you can iterate on. */
+export interface StudioAsset {
+    /** Stable id — pass to `studio.edit({ assetId })` to iterate. */
+    id: string;
+    /** Hosted URL of the generated asset. */
+    url: string;
+    modality: string;
+    prompt?: string | null;
+    model?: string | null;
+    /** The asset this was edited from (present on variations). */
+    parentId?: string | null;
+    createdAt?: string;
+    /** Credits this creation cost. */
+    creditsCharged: number;
+    /** Wallet balance after this creation. */
+    balance: number;
+}
+export interface StudioGenerateInput {
+    prompt: string;
+    /** Only `image` is wired today (video/audio/threeD are documented, not yet live). */
+    modality?: 'image' | 'video' | 'audio' | 'threeD';
+    size?: string;
+    quality?: 'low' | 'medium' | 'high';
+    /** Ground the output in a brand's rules (accepted; not yet enforced). */
+    brandId?: string;
+}
+export interface StudioEditInput {
+    /** Id of the asset to iterate on (from a previous generate/edit). */
+    assetId: string;
+    instruction: string;
+    size?: string;
+    quality?: 'low' | 'medium' | 'high';
+}
+/** taskclan.studio — the multimodal creation surface. */
+export interface StudioNamespace {
+    /** Create an asset (image today). Metered against your wallet. */
+    generate(input: StudioGenerateInput): Promise<StudioAsset>;
+    /** Iterate on an existing asset by id → a new variation asset. Metered. */
+    edit(input: StudioEditInput): Promise<StudioAsset>;
+}
+export declare class Taskclan {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly defaultProfile;
+    private readonly fetchImpl;
+    readonly run: RunFn;
+    /** Multimodal creation — `studio.generate()` / `studio.edit()`. */
+    readonly studio: StudioNamespace;
+    /** Deterministic workflows — `engine.run(workflow, { input })`. */
+    readonly engine: EngineNamespace;
+    constructor(config?: TaskclanConfig);
+    /** Turn a goal (+ optional structured input) into the single prompt string. */
+    private buildPrompt;
+    /** Build the (toolless) request body the T1 API expects from a run input. */
+    private buildBody;
+    private headers;
+    /** POST JSON to a T1 endpoint; throw TaskclanError on non-2xx; return the parsed body. */
+    private _post;
+    private _run;
+    /**
+     * Client-orchestrated tool loop. Tools run on the CALLER, so each turn: ask the
+     * model (with the tool schemas); if it requests tools, run them locally and
+     * replay the results as tool_use/tool_result messages; repeat until it answers
+     * (or maxSteps). Usage + credits are summed across every metered turn.
+     */
+    private _runWithTools;
+    /** POST to /api/t1/stream and return the SSE event iterator (throws on non-2xx). */
+    private _openStream;
+    private _stream;
+    /**
+     * Streaming tool loop: stream each turn's text; when a turn ends in tool calls,
+     * emit tool_call events, run the handlers LOCALLY, emit tool_result events, and
+     * open the next streaming turn with the results — until a final answer. Emits
+     * text / tool_call / tool_result / done / error. Each turn is metered.
+     */
+    private _streamWithTools;
+}
+//# sourceMappingURL=t1.d.ts.map

package/dist/t1.d.ts.map

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

package/dist/t1.js

@@ -0,0 +1,378 @@
+"use strict";
+/**
+ * Taskclan — the T1 developer client.
+ *
+ *   import { Taskclan } from "@taskclan/sdk";
+ *   const taskclan = new Taskclan({ apiKey: process.env.TASKCLAN_API_KEY });
+ *   const result = await taskclan.run({ profile: "t1-flow", goal: "…", input: {…} });
+ *   console.log(result.output);
+ *
+ * A run takes a goal (+ optional structured input) and returns a verified result.
+ * The profile picks the model/reasoning depth: t1-core (fast), t1-flow (balanced,
+ * default), t1-max (deep). Backed by the metered T1 API — spend debits the key's
+ * wallet. `run.stream(...)` yields tokens as they generate.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Taskclan = exports.TaskclanError = void 0;
+exports.tool = tool;
+const zod_to_json_schema_1 = require("zod-to-json-schema");
+const engine_1 = require("./engine");
+const DEFAULT_BASE_URL = 'https://engine.taskclan.com';
+/** Read an env var without depending on @types/node (works in Node, edge, browser). */
+function readEnv(name) {
+    const g = globalThis;
+    return g.process?.env?.[name];
+}
+/** Define a typed tool. Pass the returned object to `run({ tools: [...] })`. */
+function tool(def) {
+    return def;
+}
+class TaskclanError extends Error {
+    constructor(message, status, code, balance, requestId) {
+        super(message);
+        this.name = 'TaskclanError';
+        this.status = status;
+        this.code = code;
+        this.balance = balance;
+        this.requestId = requestId;
+        this.retryable = status === 429 || status >= 500;
+        this.type =
+            status === 401 ? 'authentication'
+                : status === 402 ? 'insufficient_credits'
+                    : status === 400 ? 'invalid_request'
+                        : status === 429 ? 'rate_limit'
+                            : 'api';
+    }
+}
+exports.TaskclanError = TaskclanError;
+class Taskclan {
+    constructor(config = {}) {
+        this.apiKey = config.apiKey ?? readEnv('TASKCLAN_API_KEY') ?? '';
+        this.baseUrl = (config.baseUrl ?? readEnv('TASKCLAN_BASE_URL') ?? DEFAULT_BASE_URL).replace(/\/$/, '');
+        this.defaultProfile = config.profile ?? 't1-flow';
+        const f = config.fetch ?? (typeof fetch !== 'undefined' ? fetch : undefined);
+        if (!f)
+            throw new Error('No fetch implementation available — pass { fetch } to the Taskclan constructor.');
+        this.fetchImpl = f;
+        const run = ((input) => input.tools?.length ? this._runWithTools(input) : this._run(input));
+        run.stream = (input) => this._stream(input);
+        this.run = run;
+        this.studio = {
+            generate: (input) => this._post('/api/t1/studio/generate', input),
+            edit: (input) => this._post('/api/t1/studio/edit', input),
+        };
+        // The engine orchestrates workflows over this client's own run + studio.
+        this.engine = (0, engine_1.createEngine)({ run: this.run, studio: this.studio });
+    }
+    /** Turn a goal (+ optional structured input) into the single prompt string. */
+    buildPrompt(input) {
+        if (!input?.goal)
+            throw new Error('run() requires a `goal`.');
+        return input.input !== undefined
+            ? `${input.goal}\n\nInput:\n${typeof input.input === 'string' ? input.input : JSON.stringify(input.input, null, 2)}`
+            : input.goal;
+    }
+    /** Build the (toolless) request body the T1 API expects from a run input. */
+    buildBody(input) {
+        return {
+            tier: input.profile ?? this.defaultProfile,
+            prompt: this.buildPrompt(input),
+            ...(input.system ? { system: input.system } : {}),
+            ...(input.maxTokens ? { maxTokens: input.maxTokens } : {}),
+            ...(input.temperature !== undefined ? { temperature: input.temperature } : {}),
+        };
+    }
+    headers() {
+        if (!this.apiKey) {
+            throw new TaskclanError('Missing API key — set TASKCLAN_API_KEY or pass { apiKey }.', 401, 'no_api_key');
+        }
+        return { 'Content-Type': 'application/json', Authorization: `Bearer ${this.apiKey}` };
+    }
+    /** POST JSON to a T1 endpoint; throw TaskclanError on non-2xx; return the parsed body. */
+    async _post(path, body) {
+        const res = await this.fetchImpl(`${this.baseUrl}${path}`, {
+            method: 'POST',
+            headers: this.headers(),
+            body: JSON.stringify(body),
+        });
+        const data = (await res.json().catch(() => ({})));
+        if (!res.ok) {
+            throw new TaskclanError(String(data.error ?? `request failed (${res.status})`), res.status, typeof data.error === 'string' ? data.error : undefined, typeof data.balance === 'number' ? data.balance : undefined, res.headers.get('x-request-id') ?? (typeof data.requestId === 'string' ? data.requestId : undefined));
+        }
+        return data;
+    }
+    async _run(input) {
+        const data = await this._post('/api/t1/complete', this.buildBody(input));
+        return {
+            output: String(data.text ?? ''),
+            profile: String(data.tier ?? input.profile ?? this.defaultProfile),
+            model: data.model,
+            usage: data.usage,
+            creditsCharged: Number(data.creditsCharged ?? 0),
+            balance: Number(data.balance ?? 0),
+            finishReason: data.finishReason,
+        };
+    }
+    /**
+     * Client-orchestrated tool loop. Tools run on the CALLER, so each turn: ask the
+     * model (with the tool schemas); if it requests tools, run them locally and
+     * replay the results as tool_use/tool_result messages; repeat until it answers
+     * (or maxSteps). Usage + credits are summed across every metered turn.
+     */
+    async _runWithTools(input) {
+        const tools = input.tools ?? [];
+        const apiTools = tools.map((t) => ({ name: t.name, description: t.description, inputSchema: toInputSchema(t.input) }));
+        const byName = new Map(tools.map((t) => [t.name, t]));
+        const messages = [{ role: 'user', content: this.buildPrompt(input) }];
+        const steps = [];
+        const maxSteps = input.maxSteps ?? 8;
+        let inTok = 0;
+        let outTok = 0;
+        let credits = 0;
+        let model;
+        let balance = 0;
+        let profile = String(input.profile ?? this.defaultProfile);
+        for (let step = 0; step < maxSteps; step++) {
+            const data = await this._post('/api/t1/complete', {
+                tier: input.profile ?? this.defaultProfile,
+                messages,
+                ...(input.system ? { system: input.system } : {}),
+                tools: apiTools,
+                ...(input.maxTokens ? { maxTokens: input.maxTokens } : {}),
+                ...(input.temperature !== undefined ? { temperature: input.temperature } : {}),
+            });
+            const usage = data.usage;
+            inTok += usage?.inputTokens ?? 0;
+            outTok += usage?.outputTokens ?? 0;
+            credits += Number(data.creditsCharged ?? 0);
+            model = data.model ?? model;
+            balance = Number(data.balance ?? balance);
+            profile = String(data.tier ?? profile);
+            const toolCalls = data.toolCalls ?? [];
+            if (toolCalls.length === 0) {
+                return {
+                    output: String(data.text ?? ''),
+                    profile,
+                    model,
+                    usage: { inputTokens: inTok, outputTokens: outTok },
+                    creditsCharged: credits,
+                    balance,
+                    finishReason: data.finishReason,
+                    steps,
+                };
+            }
+            // Record the model's tool-call turn.
+            messages.push({
+                role: 'assistant',
+                content: [
+                    ...(data.text ? [{ type: 'text', text: String(data.text) }] : []),
+                    ...toolCalls.map((tc) => ({ type: 'tool_use', id: tc.id, name: tc.name, input: tc.input })),
+                ],
+            });
+            // Run each requested tool locally; collect results to feed back.
+            const resultParts = [];
+            for (const tc of toolCalls) {
+                steps.push({ type: 'tool_call', name: tc.name, input: tc.input });
+                const def = byName.get(tc.name);
+                let content;
+                let isError = false;
+                if (!def) {
+                    content = `Unknown tool "${tc.name}".`;
+                    isError = true;
+                }
+                else {
+                    const parsed = def.input?.safeParse ? def.input.safeParse(tc.input) : { success: true, data: tc.input };
+                    if (!parsed.success) {
+                        content = `Invalid input for "${tc.name}": ${JSON.stringify(parsed.error)}`;
+                        isError = true;
+                    }
+                    else {
+                        try {
+                            const out = await def.run(parsed.data);
+                            content = typeof out === 'string' ? out : JSON.stringify(out);
+                        }
+                        catch (e) {
+                            content = `Error: ${e.message}`;
+                            isError = true;
+                        }
+                    }
+                }
+                steps.push({ type: 'tool_result', name: tc.name, output: content, isError });
+                resultParts.push({ type: 'tool_result', toolUseId: tc.id, content, isError });
+            }
+            messages.push({ role: 'user', content: resultParts });
+        }
+        // Hit maxSteps with tools still pending.
+        return {
+            output: '',
+            profile,
+            model,
+            usage: { inputTokens: inTok, outputTokens: outTok },
+            creditsCharged: credits,
+            balance,
+            steps,
+            maxStepsReached: true,
+        };
+    }
+    /** POST to /api/t1/stream and return the SSE event iterator (throws on non-2xx). */
+    async _openStream(body) {
+        const res = await this.fetchImpl(`${this.baseUrl}/api/t1/stream`, {
+            method: 'POST',
+            headers: this.headers(),
+            body: JSON.stringify(body),
+        });
+        if (!res.ok || !res.body) {
+            const data = (await res.json().catch(() => ({})));
+            throw new TaskclanError(String(data.error ?? `request failed (${res.status})`), res.status, typeof data.error === 'string' ? data.error : undefined, typeof data.balance === 'number' ? data.balance : undefined, res.headers.get('x-request-id') ?? (typeof data.requestId === 'string' ? data.requestId : undefined));
+        }
+        return parseSSE(res.body);
+    }
+    _stream(input) {
+        if (input.tools?.length)
+            return Promise.resolve(this._streamWithTools(input));
+        return this._openStream(this.buildBody(input));
+    }
+    /**
+     * Streaming tool loop: stream each turn's text; when a turn ends in tool calls,
+     * emit tool_call events, run the handlers LOCALLY, emit tool_result events, and
+     * open the next streaming turn with the results — until a final answer. Emits
+     * text / tool_call / tool_result / done / error. Each turn is metered.
+     */
+    async *_streamWithTools(input) {
+        const tools = input.tools ?? [];
+        const apiTools = tools.map((t) => ({ name: t.name, description: t.description, inputSchema: toInputSchema(t.input) }));
+        const byName = new Map(tools.map((t) => [t.name, t]));
+        const messages = [{ role: 'user', content: this.buildPrompt(input) }];
+        const steps = [];
+        const maxSteps = input.maxSteps ?? 8;
+        let inTok = 0;
+        let outTok = 0;
+        let credits = 0;
+        let model;
+        let balance = 0;
+        let finishReason;
+        for (let step = 0; step < maxSteps; step++) {
+            const events = await this._openStream({
+                tier: input.profile ?? this.defaultProfile,
+                messages,
+                ...(input.system ? { system: input.system } : {}),
+                tools: apiTools,
+                ...(input.maxTokens ? { maxTokens: input.maxTokens } : {}),
+                ...(input.temperature !== undefined ? { temperature: input.temperature } : {}),
+            });
+            let turnText = '';
+            let done = null;
+            for await (const ev of events) {
+                if (ev.type === 'text') {
+                    turnText += ev.delta;
+                    yield ev;
+                }
+                else if (ev.type === 'done') {
+                    done = ev;
+                }
+                else if (ev.type === 'error') {
+                    yield ev;
+                    return;
+                }
+            }
+            if (!done) {
+                yield { type: 'error', error: 'stream ended without a done event' };
+                return;
+            }
+            credits += done.creditsCharged ?? 0;
+            balance = done.balance ?? balance;
+            model = done.model ?? model;
+            finishReason = done.finishReason ?? finishReason;
+            inTok += done.usage?.inputTokens ?? 0;
+            outTok += done.usage?.outputTokens ?? 0;
+            const toolCalls = done.toolCalls ?? [];
+            if (toolCalls.length === 0) {
+                yield { type: 'done', model, usage: { inputTokens: inTok, outputTokens: outTok }, creditsCharged: credits, balance, finishReason, steps };
+                return;
+            }
+            // Record the model's (streamed) tool-call turn, run each tool, feed results back.
+            messages.push({
+                role: 'assistant',
+                content: [
+                    ...(turnText ? [{ type: 'text', text: turnText }] : []),
+                    ...toolCalls.map((tc) => ({ type: 'tool_use', id: tc.id, name: tc.name, input: tc.input })),
+                ],
+            });
+            const resultParts = [];
+            for (const tc of toolCalls) {
+                yield { type: 'tool_call', name: tc.name, input: tc.input };
+                steps.push({ type: 'tool_call', name: tc.name, input: tc.input });
+                const def = byName.get(tc.name);
+                let content;
+                let isError = false;
+                if (!def) {
+                    content = `Unknown tool "${tc.name}".`;
+                    isError = true;
+                }
+                else {
+                    const parsed = def.input?.safeParse ? def.input.safeParse(tc.input) : { success: true, data: tc.input };
+                    if (!parsed.success) {
+                        content = `Invalid input for "${tc.name}": ${JSON.stringify(parsed.error)}`;
+                        isError = true;
+                    }
+                    else {
+                        try {
+                            const out = await def.run(parsed.data);
+                            content = typeof out === 'string' ? out : JSON.stringify(out);
+                        }
+                        catch (e) {
+                            content = `Error: ${e.message}`;
+                            isError = true;
+                        }
+                    }
+                }
+                steps.push({ type: 'tool_result', name: tc.name, output: content, isError });
+                yield { type: 'tool_result', name: tc.name, output: content, isError };
+                resultParts.push({ type: 'tool_result', toolUseId: tc.id, content, isError });
+            }
+            messages.push({ role: 'user', content: resultParts });
+        }
+        yield { type: 'done', model, usage: { inputTokens: inTok, outputTokens: outTok }, creditsCharged: credits, balance, steps };
+    }
+}
+exports.Taskclan = Taskclan;
+/** A Zod schema → JSON Schema (for the API). Falls through for plain schema objects. */
+function toInputSchema(input) {
+    if (input && typeof input._def !== 'undefined') {
+        const js = (0, zod_to_json_schema_1.zodToJsonSchema)(input, { $refStrategy: 'none' });
+        delete js.$schema;
+        return js;
+    }
+    if (input && typeof input === 'object')
+        return input;
+    return { type: 'object', properties: {} };
+}
+/** Parse a text/event-stream body into RunStreamEvent objects. */
+async function* parseSSE(body) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = '';
+    for (;;) {
+        const { value, done } = await reader.read();
+        if (done)
+            break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split('\n');
+        buffer = lines.pop() ?? '';
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed.startsWith('data:'))
+                continue;
+            const payload = trimmed.slice(5).trim();
+            if (payload === '[DONE]' || !payload)
+                continue;
+            try {
+                yield JSON.parse(payload);
+            }
+            catch {
+                // ignore malformed keepalive chunk
+            }
+        }
+    }
+}
+//# sourceMappingURL=t1.js.map

package/dist/t1.js.map

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

package/package.json

@@ -1,11 +1,13 @@
 {
   "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.",
+  "version": "1.1.0",
+  "description": "Typed client for Taskclan Intelligence. The T1 developer client — new Taskclan({apiKey}).run({goal}) against the metered T1 API (core/flow/max profiles, streaming) — plus the L3 agentic layer (named agents/skills, shared memory, insights, registries) built on @taskclan/platform.",
   "license": "UNLICENSED",
   "author": "Taskclan",
   "private": false,
-  "publishConfig": { "access": "public" },
+  "publishConfig": {
+    "access": "public"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/taskclan/taskclan-monorepo.git",
@@ -41,9 +43,13 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@taskclan/platform": "^0.2.0"
+    "@taskclan/platform": "^0.2.0",
+    "zod-to-json-schema": "^3.25.2"
   },
   "devDependencies": {
     "typescript": "^5.5.4"
+  },
+  "peerDependencies": {
+    "zod": "^3.25.76"
   }
 }