@kortix/sdk 0.9.98

package/dist/index.js

@@ -0,0 +1,93 @@
+/**
+ * @kortix/sdk — the Kortix frontend data layer, in one package.
+ *
+ * Configure once at startup, then use the React hooks (`@kortix/sdk/react`) or
+ * the data modules (subpath imports below). Every host — web, mobile, demo —
+ * shares this single implementation; nothing talks to the raw API or OpenCode.
+ *
+ * The data modules are exposed as subpaths (not merged here) to keep the
+ * surface collision-free and tree-shakeable:
+ *   @kortix/sdk/react            — all useOpenCode* hooks + providers
+ *   @kortix/sdk/opencode-client  — the scoped OpenCode v2 client factory
+ *   @kortix/sdk/auth             — authenticatedFetch + token accessors
+ *   @kortix/sdk/api-client       — backendApi (typed REST)
+ *   @kortix/sdk/projects-client  — project/session REST surface
+ *   @kortix/sdk/server-store     — active sandbox/server state
+ *   @kortix/sdk/sync-store       — live message/part/status store
+ *   @kortix/sdk/event-stream     — framework-free SSE connect/reconnect/coalesce primitive
+ */
+export { configureKortix, platformConfig, isConfigured, } from './platform/config.js';
+/**
+ * The opinionated single entry point. `createKortix({ getToken })` wires the
+ * platform seam and returns one client whose methods cover the whole REST +
+ * opencode surface — so a host app imports ONLY from `@kortix/sdk`.
+ */
+export { createKortix, SessionNotReadyError, } from './kortix.js';
+/** Workspace file operations (daemon `/file` + `/find`), owned by the SDK. */
+export { files } from './files/client.js';
+/** Generate a session id (RFC 4122 v4, with a non-secure-context fallback). */
+export { generateSessionId } from './platform/session-id.js';
+/**
+ * Session transcript formatting — pure `SessionInfo`/`MessageWithParts` →
+ * Markdown, zero DOM deps, so any host (web, mobile, CLI) exports a transcript
+ * the same way.
+ */
+export { DEFAULT_TRANSCRIPT_OPTIONS, formatTranscript, getTranscriptFilename, } from './transcript.js';
+/**
+ * The framework-free SSE event-stream primitive — connect/reconnect/backoff,
+ * heartbeat watchdog, and event coalescing, with ZERO react/react-query
+ * imports. `@kortix/sdk/react`'s `useOpenCodeEventStream` is a thin wrapper
+ * around this for the React host; any other host (worker, CLI, non-React UI)
+ * can call it directly.
+ */
+export { openEventStream, } from './state/event-stream.js';
+/**
+ * Typed error classes for the REST surface — isomorphic (no DOM/React deps),
+ * so a server-side "Kortix as a Backend" wrapper can `catch` a call into
+ * `backendApi`/`createKortix(...)`, `instanceof BillingError` a 402 and pass
+ * the cost/upgrade payload straight through to its own client, or
+ * `instanceof ApiError` to branch on `.status`/`.code`. Same classes the
+ * React host uses (`@kortix/sdk/react` re-exports from this same module) —
+ * one error hierarchy across every host.
+ */
+export { ApiError, AuthError, BillingError, RequestTooLargeError, parseBillingError, isBillingError, formatBillingErrorForUI, } from './platform/api/errors.js';
+/**
+ * Exhaustive part/turn classification for building chat UIs — framework-free.
+ * `classifyPart` normalizes every opencode `Part` variant (text, reasoning,
+ * tool, file, subtask, patch, snapshot, agent, retry, compaction, step) into
+ * a `ClassifiedPart`, with a compile-time exhaustiveness check plus a runtime
+ * 'unknown' fallback for forward-compat. `classifyTurn` classifies every part
+ * of a message and normalizes its `info.error` into a `TurnError`, so a host
+ * doesn't have to special-case "assistant message with zero parts but a
+ * failure" as silent nothingness. `toolInfo` is a zero-icon tool-name ->
+ * {label, category} registry a host maps to its own icon set. Also available
+ * from `@kortix/sdk/turns`.
+ */
+export { classifyPart, classifyTurn, humanizeToolName, toolInfo, } from './turns/index.js';
+/**
+ * The curated chat-event union — narrows the full `OpenCodeEvent` wire union
+ * down to the ~12 events a product chat UI needs (message/part updates,
+ * session status/idle/error, question asked/answered, permission
+ * asked/replied, todo updated, connection, heartbeat-gap), reshaped into
+ * purpose-built payloads. Also available from `@kortix/sdk/event-stream`.
+ */
+export { heartbeatGapEvent, narrowChatEvent, } from './state/chat-events.js';
+/**
+ * Linear-time trailing-slash strip shared with hosts — see
+ * `platform/strings.ts` for why this replaces the regex idiom.
+ */
+export { stripTrailingSlashes } from './platform/strings.js';
+/**
+ * Per-tool view models for `ToolView` — a discriminated union with a typed
+ * shape for each tool family a product chat UI renders specially (web/image
+ * search, shell, file read/write/edit, grep/glob search, task, todowrite,
+ * question), plus a `generic` fallback for everything else. Pairs with
+ * `ToolView`'s new `outputParsed`/`outputText` fields and its embedded-
+ * failure detection (a `state.status: "completed"` tool part whose JSON
+ * output body carries `success: false` or a top-level `error` — the shape
+ * router/executor tools like `web_search` commonly return on failure — now
+ * classifies as `status: 'error'` instead of rendering as a success with raw
+ * JSON inside). Also available from `@kortix/sdk/turns`.
+ */
+export { toolViewModel, } from './turns/view-model.js';
+//# 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;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EACL,eAAe,EACf,cAAc,EACd,YAAY,GAGb,MAAM,mBAAmB,CAAC;AAE3B;;;;GAIG;AACH,OAAO,EACL,YAAY,EACZ,oBAAoB,GAKrB,MAAM,UAAU,CAAC;AAElB,8EAA8E;AAC9E,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGvC,+EAA+E;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;GAIG;AACH,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,GAItB,MAAM,cAAc,CAAC;AAoBtB;;;;;;GAMG;AACH,OAAO,EACL,eAAe,GAMhB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;GAQG;AACH,OAAO,EACL,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,uBAAuB,GAGxB,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;;;GAWG;AACH,OAAO,EAoBL,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,QAAQ,GACT,MAAM,eAAe,CAAC;AAEvB;;;;;;GAMG;AACH,OAAO,EACL,iBAAiB,EACjB,eAAe,GAmBhB,MAAM,qBAAqB,CAAC;AAyG7B;;;GAGG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;;;;;;;;;;GAWG;AACH,OAAO,EASL,aAAa,GACd,MAAM,oBAAoB,CAAC"}