@jenz-ai/sdk 0.1.0

package/README.md

@@ -0,0 +1,86 @@
+# @jenz-ai/sdk
+
+Client SDK for [Jenz](https://jenz.dev) — observability for AI agents. Track runs, events, costs, and latency from any Node.js process.
+
+## Install
+
+```bash
+npm install @jenz-ai/sdk
+# or
+pnpm add @jenz-ai/sdk
+# or
+yarn add @jenz-ai/sdk
+```
+
+## Usage
+
+```ts
+import { Jenz } from '@jenz-ai/sdk';
+
+const jenz = new Jenz({
+  apiKey: process.env.JENZ_API_KEY!,
+  baseUrl: process.env.JENZ_BASE_URL ?? 'https://api.jenz.dev',
+  agentName: 'my-agent',
+  agentType: 'scheduled',
+});
+
+const run = await jenz.startRun({
+  input: 'Summarize today’s sales report',
+  expectedDurationMs: 60_000,
+});
+if (!run) return; // backend unavailable — host-safe
+
+const evt = run.startEvent({
+  type: 'llm_call',
+  model: 'claude-haiku-4-5',
+  input: prompt,
+});
+
+// ... call your LLM ...
+const response = await callLlm(prompt);
+
+await evt.finish({
+  output: response.text,
+  inputTokens: response.usage.input_tokens,
+  outputTokens: response.usage.output_tokens,
+});
+
+await run.finish({ status: 'completed', output: response.text });
+```
+
+## API
+
+### `new Jenz(options)`
+
+| Option | Type | Description |
+|---|---|---|
+| `apiKey` | `string` | API key from your Jenz dashboard. |
+| `baseUrl` | `string` | Backend URL. Defaults to `https://api.jenz.dev` (or set per environment). |
+| `agentName` | `string` | Stable identifier for the agent (e.g. `seo-agent`). |
+| `agentType` | `string` | Free-form classifier (e.g. `scheduled`, `webhook`, `chat`). |
+
+### `jenz.startRun({ input, expectedDurationMs?, metadata? })`
+
+Starts a run. Returns `Run | null` — `null` indicates the backend was unreachable and the SDK gracefully no-op'd.
+
+### `run.startEvent({ type, model?, input, parentEventId?, metadata? })`
+
+Starts an event under the run. `type` is `'llm_call' | 'tool_call' | 'log'`. Returns an `Event`.
+
+### `event.finish({ output, inputTokens?, outputTokens?, costUsd?, errorMessage?, metadata? })`
+
+Finishes an event. If `costUsd` is omitted, the backend computes from `model` + tokens.
+
+### `run.finish({ status, output?, errorMessage?, metadata? })`
+
+Finishes the run. `status` is `'completed' | 'errored' | 'stopped'`.
+
+**Important:** Await all `event.finish()` calls before `run.finish()` — the backend sets the run's `endedAt` on the run-finish PATCH.
+
+## Failure model
+
+The SDK is fire-and-forget: HTTP errors never throw. `Jenz.startRun` returns `null` on failure so your host process keeps running. `Run.finish` and `Event.finish` only throw on a programmer error (calling `finish()` twice on the same object).
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,177 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Event: () => Event,
+  Jenz: () => Jenz,
+  Run: () => Run,
+  SDK_VERSION: () => SDK_VERSION
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/event.ts
+var Event = class {
+  transport;
+  init;
+  startedAt = /* @__PURE__ */ new Date();
+  finished = false;
+  constructor(init) {
+    this.transport = init.transport;
+    this.init = init;
+  }
+  async finish(input) {
+    if (this.finished) throw new Error("Event already finished");
+    this.finished = true;
+    const endedAt = /* @__PURE__ */ new Date();
+    await this.transport.post("/v1/events", {
+      runId: this.init.runId,
+      parentEventId: this.init.parentEventId,
+      type: this.init.type,
+      model: this.init.model,
+      input: this.init.input,
+      output: input.output,
+      inputTokens: input.inputTokens,
+      outputTokens: input.outputTokens,
+      costUsd: input.costUsd,
+      errorMessage: input.errorMessage,
+      metadata: input.metadata ?? this.init.metadata,
+      startedAt: this.startedAt.toISOString(),
+      endedAt: endedAt.toISOString(),
+      latencyMs: endedAt.getTime() - this.startedAt.getTime()
+    });
+  }
+};
+
+// src/run.ts
+var Run = class {
+  id;
+  transport;
+  finished = false;
+  constructor(init) {
+    this.id = init.runId;
+    this.transport = init.transport;
+  }
+  startEvent(input) {
+    const eventInit = {
+      transport: this.transport,
+      runId: this.id,
+      type: input.type,
+      parentEventId: input.parentEventId,
+      model: input.model,
+      input: input.input,
+      metadata: input.metadata
+    };
+    return new Event(eventInit);
+  }
+  /** Await all in-flight `Event.finish()` promises before calling — the run's
+   * `endedAt` is set server-side on the PATCH, so events that arrive after will
+   * not be associated with the run's duration in the dashboard. */
+  async finish(input) {
+    if (this.finished) throw new Error("Run already finished");
+    this.finished = true;
+    await this.transport.patch(`/v1/runs/${this.id}`, {
+      status: input.status,
+      output: input.output,
+      errorMessage: input.errorMessage,
+      metadata: input.metadata
+    });
+  }
+};
+
+// src/transport.ts
+var Transport = class {
+  baseUrl;
+  apiKey;
+  constructor(opts) {
+    this.baseUrl = opts.baseUrl.replace(/\/$/, "");
+    this.apiKey = opts.apiKey;
+  }
+  async post(path, body) {
+    return await this.send("POST", path, body);
+  }
+  async patch(path, body) {
+    return await this.send("PATCH", path, body);
+  }
+  async get(path) {
+    return await this.send("GET", path, void 0);
+  }
+  async send(method, path, body) {
+    const url = `${this.baseUrl}${path}`;
+    try {
+      const res = await fetch(url, {
+        method,
+        headers: {
+          Authorization: `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json"
+        },
+        body: body === void 0 ? void 0 : JSON.stringify(body)
+      });
+      if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        console.error(`[jenz] ${method} ${path} \u2192 ${res.status} ${text}`);
+        return null;
+      }
+      if (res.status === 204) return null;
+      return await res.json();
+    } catch (err) {
+      console.error(`[jenz] ${method} ${path} failed:`, err);
+      return null;
+    }
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.jenz.run";
+var Jenz = class {
+  transport;
+  agentName;
+  agentType;
+  constructor(opts) {
+    this.transport = new Transport({
+      baseUrl: opts.baseUrl ?? DEFAULT_BASE_URL,
+      apiKey: opts.apiKey
+    });
+    this.agentName = opts.agentName;
+    this.agentType = opts.agentType;
+  }
+  async startRun(input) {
+    const res = await this.transport.post("/v1/runs", {
+      agentName: this.agentName,
+      agentType: this.agentType,
+      input: input.input,
+      expectedDurationMs: input.expectedDurationMs,
+      metadata: input.metadata
+    });
+    if (!res) return null;
+    return new Run({ transport: this.transport, runId: res.runId });
+  }
+};
+
+// src/index.ts
+var SDK_VERSION = "0.0.1";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Event,
+  Jenz,
+  Run,
+  SDK_VERSION
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/event.ts","../src/run.ts","../src/transport.ts","../src/client.ts"],"sourcesContent":["export { Jenz } from './client.js';\nexport { Run } from './run.js';\nexport { Event } from './event.js';\nexport type { JenzOptions, AgentType, StartRunInput } from './client.js';\nexport type { RunStatus, RunFinishInput, StartEventInput } from './run.js';\nexport type { EventType, EventFinishInput } from './event.js';\n\nexport const SDK_VERSION = '0.0.1';\n","import type { Transport } from './transport.js';\n\nexport type EventType = 'llm_call' | 'tool_call' | 'log';\n\nexport interface EventInit {\n  transport: Transport;\n  runId: string;\n  parentEventId?: string;\n  type: EventType;\n  model?: string;\n  input?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface EventFinishInput {\n  output?: string;\n  inputTokens?: number;\n  outputTokens?: number;\n  costUsd?: number;\n  errorMessage?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport class Event {\n  private readonly transport: Transport;\n  private readonly init: EventInit;\n  private readonly startedAt: Date = new Date();\n  private finished = false;\n\n  constructor(init: EventInit) {\n    this.transport = init.transport;\n    this.init = init;\n  }\n\n  async finish(input: EventFinishInput): Promise<void> {\n    if (this.finished) throw new Error('Event already finished');\n    this.finished = true;\n    const endedAt = new Date();\n    await this.transport.post('/v1/events', {\n      runId: this.init.runId,\n      parentEventId: this.init.parentEventId,\n      type: this.init.type,\n      model: this.init.model,\n      input: this.init.input,\n      output: input.output,\n      inputTokens: input.inputTokens,\n      outputTokens: input.outputTokens,\n      costUsd: input.costUsd,\n      errorMessage: input.errorMessage,\n      metadata: input.metadata ?? this.init.metadata,\n      startedAt: this.startedAt.toISOString(),\n      endedAt: endedAt.toISOString(),\n      latencyMs: endedAt.getTime() - this.startedAt.getTime(),\n    });\n  }\n}\n","import { Event, type EventInit, type EventType } from './event.js';\nimport type { Transport } from './transport.js';\n\nexport type RunStatus = 'running' | 'completed' | 'errored' | 'stopped';\n\nexport interface RunInit {\n  transport: Transport;\n  runId: string;\n}\n\nexport interface StartEventInput {\n  type: EventType;\n  parentEventId?: string;\n  model?: string;\n  input?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface RunFinishInput {\n  status: RunStatus;\n  output?: string;\n  errorMessage?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport class Run {\n  readonly id: string;\n  private readonly transport: Transport;\n  private finished = false;\n\n  constructor(init: RunInit) {\n    this.id = init.runId;\n    this.transport = init.transport;\n  }\n\n  startEvent(input: StartEventInput): Event {\n    const eventInit: EventInit = {\n      transport: this.transport,\n      runId: this.id,\n      type: input.type,\n      parentEventId: input.parentEventId,\n      model: input.model,\n      input: input.input,\n      metadata: input.metadata,\n    };\n    return new Event(eventInit);\n  }\n\n  /** Await all in-flight `Event.finish()` promises before calling — the run's\n   * `endedAt` is set server-side on the PATCH, so events that arrive after will\n   * not be associated with the run's duration in the dashboard. */\n  async finish(input: RunFinishInput): Promise<void> {\n    if (this.finished) throw new Error('Run already finished');\n    this.finished = true;\n    await this.transport.patch(`/v1/runs/${this.id}`, {\n      status: input.status,\n      output: input.output,\n      errorMessage: input.errorMessage,\n      metadata: input.metadata,\n    });\n  }\n}\n","export interface TransportOptions {\n  baseUrl: string;\n  apiKey: string;\n}\n\nexport class Transport {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n\n  constructor(opts: TransportOptions) {\n    this.baseUrl = opts.baseUrl.replace(/\\/$/, '');\n    this.apiKey = opts.apiKey;\n  }\n\n  async post<T>(path: string, body: unknown): Promise<T | null> {\n    return await this.send<T>('POST', path, body);\n  }\n\n  async patch<T>(path: string, body: unknown): Promise<T | null> {\n    return await this.send<T>('PATCH', path, body);\n  }\n\n  async get<T>(path: string): Promise<T | null> {\n    return await this.send<T>('GET', path, undefined);\n  }\n\n  private async send<T>(\n    method: string,\n    path: string,\n    body: unknown,\n  ): Promise<T | null> {\n    const url = `${this.baseUrl}${path}`;\n    try {\n      const res = await fetch(url, {\n        method,\n        headers: {\n          Authorization: `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n        },\n        body: body === undefined ? undefined : JSON.stringify(body),\n      });\n      if (!res.ok) {\n        const text = await res.text().catch(() => '');\n        console.error(`[jenz] ${method} ${path} → ${res.status} ${text}`);\n        return null;\n      }\n      if (res.status === 204) return null;\n      return (await res.json()) as T;\n    } catch (err) {\n      console.error(`[jenz] ${method} ${path} failed:`, err);\n      return null;\n    }\n  }\n}\n","import { Run } from './run.js';\nimport { Transport } from './transport.js';\n\nexport type AgentType = 'scheduled' | 'claude_code' | 'manual';\n\nexport interface JenzOptions {\n  apiKey: string;\n  baseUrl?: string;\n  agentName: string;\n  agentType: AgentType;\n}\n\nexport interface StartRunInput {\n  input?: string;\n  expectedDurationMs?: number;\n  metadata?: Record<string, unknown>;\n}\n\nconst DEFAULT_BASE_URL = 'https://api.jenz.run';\n\nexport class Jenz {\n  private readonly transport: Transport;\n  private readonly agentName: string;\n  private readonly agentType: AgentType;\n\n  constructor(opts: JenzOptions) {\n    this.transport = new Transport({\n      baseUrl: opts.baseUrl ?? DEFAULT_BASE_URL,\n      apiKey: opts.apiKey,\n    });\n    this.agentName = opts.agentName;\n    this.agentType = opts.agentType;\n  }\n\n  async startRun(input: StartRunInput): Promise<Run | null> {\n    const res = await this.transport.post<{ runId: string }>('/v1/runs', {\n      agentName: this.agentName,\n      agentType: this.agentType,\n      input: input.input,\n      expectedDurationMs: input.expectedDurationMs,\n      metadata: input.metadata,\n    });\n    if (!res) return null;\n    return new Run({ transport: this.transport, runId: res.runId });\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,94 @@
+interface TransportOptions {
+    baseUrl: string;
+    apiKey: string;
+}
+declare class Transport {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor(opts: TransportOptions);
+    post<T>(path: string, body: unknown): Promise<T | null>;
+    patch<T>(path: string, body: unknown): Promise<T | null>;
+    get<T>(path: string): Promise<T | null>;
+    private send;
+}
+
+type EventType = 'llm_call' | 'tool_call' | 'log';
+interface EventInit {
+    transport: Transport;
+    runId: string;
+    parentEventId?: string;
+    type: EventType;
+    model?: string;
+    input?: string;
+    metadata?: Record<string, unknown>;
+}
+interface EventFinishInput {
+    output?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    costUsd?: number;
+    errorMessage?: string;
+    metadata?: Record<string, unknown>;
+}
+declare class Event {
+    private readonly transport;
+    private readonly init;
+    private readonly startedAt;
+    private finished;
+    constructor(init: EventInit);
+    finish(input: EventFinishInput): Promise<void>;
+}
+
+type RunStatus = 'running' | 'completed' | 'errored' | 'stopped';
+interface RunInit {
+    transport: Transport;
+    runId: string;
+}
+interface StartEventInput {
+    type: EventType;
+    parentEventId?: string;
+    model?: string;
+    input?: string;
+    metadata?: Record<string, unknown>;
+}
+interface RunFinishInput {
+    status: RunStatus;
+    output?: string;
+    errorMessage?: string;
+    metadata?: Record<string, unknown>;
+}
+declare class Run {
+    readonly id: string;
+    private readonly transport;
+    private finished;
+    constructor(init: RunInit);
+    startEvent(input: StartEventInput): Event;
+    /** Await all in-flight `Event.finish()` promises before calling — the run's
+     * `endedAt` is set server-side on the PATCH, so events that arrive after will
+     * not be associated with the run's duration in the dashboard. */
+    finish(input: RunFinishInput): Promise<void>;
+}
+
+type AgentType = 'scheduled' | 'claude_code' | 'manual';
+interface JenzOptions {
+    apiKey: string;
+    baseUrl?: string;
+    agentName: string;
+    agentType: AgentType;
+}
+interface StartRunInput {
+    input?: string;
+    expectedDurationMs?: number;
+    metadata?: Record<string, unknown>;
+}
+declare class Jenz {
+    private readonly transport;
+    private readonly agentName;
+    private readonly agentType;
+    constructor(opts: JenzOptions);
+    startRun(input: StartRunInput): Promise<Run | null>;
+}
+
+declare const SDK_VERSION = "0.0.1";
+
+export { type AgentType, Event, type EventFinishInput, type EventType, Jenz, type JenzOptions, Run, type RunFinishInput, type RunStatus, SDK_VERSION, type StartEventInput, type StartRunInput };

package/dist/index.d.ts

@@ -0,0 +1,94 @@
+interface TransportOptions {
+    baseUrl: string;
+    apiKey: string;
+}
+declare class Transport {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor(opts: TransportOptions);
+    post<T>(path: string, body: unknown): Promise<T | null>;
+    patch<T>(path: string, body: unknown): Promise<T | null>;
+    get<T>(path: string): Promise<T | null>;
+    private send;
+}
+
+type EventType = 'llm_call' | 'tool_call' | 'log';
+interface EventInit {
+    transport: Transport;
+    runId: string;
+    parentEventId?: string;
+    type: EventType;
+    model?: string;
+    input?: string;
+    metadata?: Record<string, unknown>;
+}
+interface EventFinishInput {
+    output?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    costUsd?: number;
+    errorMessage?: string;
+    metadata?: Record<string, unknown>;
+}
+declare class Event {
+    private readonly transport;
+    private readonly init;
+    private readonly startedAt;
+    private finished;
+    constructor(init: EventInit);
+    finish(input: EventFinishInput): Promise<void>;
+}
+
+type RunStatus = 'running' | 'completed' | 'errored' | 'stopped';
+interface RunInit {
+    transport: Transport;
+    runId: string;
+}
+interface StartEventInput {
+    type: EventType;
+    parentEventId?: string;
+    model?: string;
+    input?: string;
+    metadata?: Record<string, unknown>;
+}
+interface RunFinishInput {
+    status: RunStatus;
+    output?: string;
+    errorMessage?: string;
+    metadata?: Record<string, unknown>;
+}
+declare class Run {
+    readonly id: string;
+    private readonly transport;
+    private finished;
+    constructor(init: RunInit);
+    startEvent(input: StartEventInput): Event;
+    /** Await all in-flight `Event.finish()` promises before calling — the run's
+     * `endedAt` is set server-side on the PATCH, so events that arrive after will
+     * not be associated with the run's duration in the dashboard. */
+    finish(input: RunFinishInput): Promise<void>;
+}
+
+type AgentType = 'scheduled' | 'claude_code' | 'manual';
+interface JenzOptions {
+    apiKey: string;
+    baseUrl?: string;
+    agentName: string;
+    agentType: AgentType;
+}
+interface StartRunInput {
+    input?: string;
+    expectedDurationMs?: number;
+    metadata?: Record<string, unknown>;
+}
+declare class Jenz {
+    private readonly transport;
+    private readonly agentName;
+    private readonly agentType;
+    constructor(opts: JenzOptions);
+    startRun(input: StartRunInput): Promise<Run | null>;
+}
+
+declare const SDK_VERSION = "0.0.1";
+
+export { type AgentType, Event, type EventFinishInput, type EventType, Jenz, type JenzOptions, Run, type RunFinishInput, type RunStatus, SDK_VERSION, type StartEventInput, type StartRunInput };

package/dist/index.js

@@ -0,0 +1,147 @@
+// src/event.ts
+var Event = class {
+  transport;
+  init;
+  startedAt = /* @__PURE__ */ new Date();
+  finished = false;
+  constructor(init) {
+    this.transport = init.transport;
+    this.init = init;
+  }
+  async finish(input) {
+    if (this.finished) throw new Error("Event already finished");
+    this.finished = true;
+    const endedAt = /* @__PURE__ */ new Date();
+    await this.transport.post("/v1/events", {
+      runId: this.init.runId,
+      parentEventId: this.init.parentEventId,
+      type: this.init.type,
+      model: this.init.model,
+      input: this.init.input,
+      output: input.output,
+      inputTokens: input.inputTokens,
+      outputTokens: input.outputTokens,
+      costUsd: input.costUsd,
+      errorMessage: input.errorMessage,
+      metadata: input.metadata ?? this.init.metadata,
+      startedAt: this.startedAt.toISOString(),
+      endedAt: endedAt.toISOString(),
+      latencyMs: endedAt.getTime() - this.startedAt.getTime()
+    });
+  }
+};
+
+// src/run.ts
+var Run = class {
+  id;
+  transport;
+  finished = false;
+  constructor(init) {
+    this.id = init.runId;
+    this.transport = init.transport;
+  }
+  startEvent(input) {
+    const eventInit = {
+      transport: this.transport,
+      runId: this.id,
+      type: input.type,
+      parentEventId: input.parentEventId,
+      model: input.model,
+      input: input.input,
+      metadata: input.metadata
+    };
+    return new Event(eventInit);
+  }
+  /** Await all in-flight `Event.finish()` promises before calling — the run's
+   * `endedAt` is set server-side on the PATCH, so events that arrive after will
+   * not be associated with the run's duration in the dashboard. */
+  async finish(input) {
+    if (this.finished) throw new Error("Run already finished");
+    this.finished = true;
+    await this.transport.patch(`/v1/runs/${this.id}`, {
+      status: input.status,
+      output: input.output,
+      errorMessage: input.errorMessage,
+      metadata: input.metadata
+    });
+  }
+};
+
+// src/transport.ts
+var Transport = class {
+  baseUrl;
+  apiKey;
+  constructor(opts) {
+    this.baseUrl = opts.baseUrl.replace(/\/$/, "");
+    this.apiKey = opts.apiKey;
+  }
+  async post(path, body) {
+    return await this.send("POST", path, body);
+  }
+  async patch(path, body) {
+    return await this.send("PATCH", path, body);
+  }
+  async get(path) {
+    return await this.send("GET", path, void 0);
+  }
+  async send(method, path, body) {
+    const url = `${this.baseUrl}${path}`;
+    try {
+      const res = await fetch(url, {
+        method,
+        headers: {
+          Authorization: `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json"
+        },
+        body: body === void 0 ? void 0 : JSON.stringify(body)
+      });
+      if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        console.error(`[jenz] ${method} ${path} \u2192 ${res.status} ${text}`);
+        return null;
+      }
+      if (res.status === 204) return null;
+      return await res.json();
+    } catch (err) {
+      console.error(`[jenz] ${method} ${path} failed:`, err);
+      return null;
+    }
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.jenz.run";
+var Jenz = class {
+  transport;
+  agentName;
+  agentType;
+  constructor(opts) {
+    this.transport = new Transport({
+      baseUrl: opts.baseUrl ?? DEFAULT_BASE_URL,
+      apiKey: opts.apiKey
+    });
+    this.agentName = opts.agentName;
+    this.agentType = opts.agentType;
+  }
+  async startRun(input) {
+    const res = await this.transport.post("/v1/runs", {
+      agentName: this.agentName,
+      agentType: this.agentType,
+      input: input.input,
+      expectedDurationMs: input.expectedDurationMs,
+      metadata: input.metadata
+    });
+    if (!res) return null;
+    return new Run({ transport: this.transport, runId: res.runId });
+  }
+};
+
+// src/index.ts
+var SDK_VERSION = "0.0.1";
+export {
+  Event,
+  Jenz,
+  Run,
+  SDK_VERSION
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/event.ts","../src/run.ts","../src/transport.ts","../src/client.ts","../src/index.ts"],"sourcesContent":["import type { Transport } from './transport.js';\n\nexport type EventType = 'llm_call' | 'tool_call' | 'log';\n\nexport interface EventInit {\n  transport: Transport;\n  runId: string;\n  parentEventId?: string;\n  type: EventType;\n  model?: string;\n  input?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface EventFinishInput {\n  output?: string;\n  inputTokens?: number;\n  outputTokens?: number;\n  costUsd?: number;\n  errorMessage?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport class Event {\n  private readonly transport: Transport;\n  private readonly init: EventInit;\n  private readonly startedAt: Date = new Date();\n  private finished = false;\n\n  constructor(init: EventInit) {\n    this.transport = init.transport;\n    this.init = init;\n  }\n\n  async finish(input: EventFinishInput): Promise<void> {\n    if (this.finished) throw new Error('Event already finished');\n    this.finished = true;\n    const endedAt = new Date();\n    await this.transport.post('/v1/events', {\n      runId: this.init.runId,\n      parentEventId: this.init.parentEventId,\n      type: this.init.type,\n      model: this.init.model,\n      input: this.init.input,\n      output: input.output,\n      inputTokens: input.inputTokens,\n      outputTokens: input.outputTokens,\n      costUsd: input.costUsd,\n      errorMessage: input.errorMessage,\n      metadata: input.metadata ?? this.init.metadata,\n      startedAt: this.startedAt.toISOString(),\n      endedAt: endedAt.toISOString(),\n      latencyMs: endedAt.getTime() - this.startedAt.getTime(),\n    });\n  }\n}\n","import { Event, type EventInit, type EventType } from './event.js';\nimport type { Transport } from './transport.js';\n\nexport type RunStatus = 'running' | 'completed' | 'errored' | 'stopped';\n\nexport interface RunInit {\n  transport: Transport;\n  runId: string;\n}\n\nexport interface StartEventInput {\n  type: EventType;\n  parentEventId?: string;\n  model?: string;\n  input?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface RunFinishInput {\n  status: RunStatus;\n  output?: string;\n  errorMessage?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport class Run {\n  readonly id: string;\n  private readonly transport: Transport;\n  private finished = false;\n\n  constructor(init: RunInit) {\n    this.id = init.runId;\n    this.transport = init.transport;\n  }\n\n  startEvent(input: StartEventInput): Event {\n    const eventInit: EventInit = {\n      transport: this.transport,\n      runId: this.id,\n      type: input.type,\n      parentEventId: input.parentEventId,\n      model: input.model,\n      input: input.input,\n      metadata: input.metadata,\n    };\n    return new Event(eventInit);\n  }\n\n  /** Await all in-flight `Event.finish()` promises before calling — the run's\n   * `endedAt` is set server-side on the PATCH, so events that arrive after will\n   * not be associated with the run's duration in the dashboard. */\n  async finish(input: RunFinishInput): Promise<void> {\n    if (this.finished) throw new Error('Run already finished');\n    this.finished = true;\n    await this.transport.patch(`/v1/runs/${this.id}`, {\n      status: input.status,\n      output: input.output,\n      errorMessage: input.errorMessage,\n      metadata: input.metadata,\n    });\n  }\n}\n","export interface TransportOptions {\n  baseUrl: string;\n  apiKey: string;\n}\n\nexport class Transport {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n\n  constructor(opts: TransportOptions) {\n    this.baseUrl = opts.baseUrl.replace(/\\/$/, '');\n    this.apiKey = opts.apiKey;\n  }\n\n  async post<T>(path: string, body: unknown): Promise<T | null> {\n    return await this.send<T>('POST', path, body);\n  }\n\n  async patch<T>(path: string, body: unknown): Promise<T | null> {\n    return await this.send<T>('PATCH', path, body);\n  }\n\n  async get<T>(path: string): Promise<T | null> {\n    return await this.send<T>('GET', path, undefined);\n  }\n\n  private async send<T>(\n    method: string,\n    path: string,\n    body: unknown,\n  ): Promise<T | null> {\n    const url = `${this.baseUrl}${path}`;\n    try {\n      const res = await fetch(url, {\n        method,\n        headers: {\n          Authorization: `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n        },\n        body: body === undefined ? undefined : JSON.stringify(body),\n      });\n      if (!res.ok) {\n        const text = await res.text().catch(() => '');\n        console.error(`[jenz] ${method} ${path} → ${res.status} ${text}`);\n        return null;\n      }\n      if (res.status === 204) return null;\n      return (await res.json()) as T;\n    } catch (err) {\n      console.error(`[jenz] ${method} ${path} failed:`, err);\n      return null;\n    }\n  }\n}\n","import { Run } from './run.js';\nimport { Transport } from './transport.js';\n\nexport type AgentType = 'scheduled' | 'claude_code' | 'manual';\n\nexport interface JenzOptions {\n  apiKey: string;\n  baseUrl?: string;\n  agentName: string;\n  agentType: AgentType;\n}\n\nexport interface StartRunInput {\n  input?: string;\n  expectedDurationMs?: number;\n  metadata?: Record<string, unknown>;\n}\n\nconst DEFAULT_BASE_URL = 'https://api.jenz.run';\n\nexport class Jenz {\n  private readonly transport: Transport;\n  private readonly agentName: string;\n  private readonly agentType: AgentType;\n\n  constructor(opts: JenzOptions) {\n    this.transport = new Transport({\n      baseUrl: opts.baseUrl ?? DEFAULT_BASE_URL,\n      apiKey: opts.apiKey,\n    });\n    this.agentName = opts.agentName;\n    this.agentType = opts.agentType;\n  }\n\n  async startRun(input: StartRunInput): Promise<Run | null> {\n    const res = await this.transport.post<{ runId: string }>('/v1/runs', {\n      agentName: this.agentName,\n      agentType: this.agentType,\n      input: input.input,\n      expectedDurationMs: input.expectedDurationMs,\n      metadata: input.metadata,\n    });\n    if (!res) return null;\n    return new Run({ transport: this.transport, runId: res.runId });\n  }\n}\n","export { Jenz } from './client.js';\nexport { Run } from './run.js';\nexport { Event } from './event.js';\nexport type { JenzOptions, AgentType, StartRunInput } from './client.js';\nexport type { RunStatus, RunFinishInput, StartEventInput } from './run.js';\nexport type { EventType, EventFinishInput } from './event.js';\n\nexport const SDK_VERSION = '0.0.1';\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@jenz-ai/sdk",
+  "version": "0.1.0",
+  "description": "Client SDK for Jenz — observability for AI agents (runs, events, costs, latency).",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": ["dist", "README.md"],
+  "license": "MIT",
+  "homepage": "https://github.com/jenz-ai/jenz-mvp/tree/main/packages/sdk",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jenz-ai/jenz-mvp.git",
+    "directory": "packages/sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/jenz-ai/jenz-mvp/issues"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "observability",
+    "tracing",
+    "llm",
+    "telemetry",
+    "jenz"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm build && pnpm test"
+  },
+  "devDependencies": {
+    "@types/node": "^22.9.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.2",
+    "vitest": "^2.1.5"
+  }
+}