@namzu/sdk 0.1.8 → 0.3.0

package/dist/types/run/status.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Domain Run status enum. See session-hierarchy.md §4.6 + §5.2 state machine.
+ *
+ * Distinct from the wire-side {@link WireRunStatus} in `contracts/api.ts`,
+ * which maps these states onto HTTP payload shapes (`completed` /
+ * `cancelling` / `expired`). Keep this enum purely the domain surface; any
+ * consumer that needs the HTTP representation should translate at the bridge
+ * boundary.
+ *
+ * Variants:
+ *  - `queued` — run created, not yet started.
+ *  - `running` — iteration loop in flight.
+ *  - `awaiting_hitl` — synchronous-wait on a HITL gate (user present).
+ *  - `awaiting_hitl_resolution` — persisted-wait after a HITL timeout under
+ *    `HITLConfig.onTimeout = 'pause_run_until_resolved'`. User absent; Run
+ *    persists until resolved or cancelled (permission-policies.md §13.3).
+ *  - `awaiting_subsession` — parent Run has delegated to a child SubSession
+ *    and is suspended until the Materializer seals the child's summary.
+ *    Session-level fan-in treats this as `active` (delegation in flight
+ *    means the parent IS active). See session-hierarchy.md §5.1.
+ *  - `succeeded` — terminal, run completed without error.
+ *  - `failed` — terminal, run errored out.
+ *  - `cancelled` — terminal, explicitly cancelled.
+ */
+export type RunStatus = 'queued' | 'running' | 'awaiting_hitl' | 'awaiting_hitl_resolution' | 'awaiting_subsession' | 'succeeded' | 'failed' | 'cancelled';
+//# sourceMappingURL=status.d.ts.map

package/dist/types/run/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/types/run/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,SAAS,GAClB,QAAQ,GACR,SAAS,GACT,eAAe,GACf,0BAA0B,GAC1B,qBAAqB,GACrB,WAAW,GACX,QAAQ,GACR,WAAW,CAAA"}

package/dist/types/run/status.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=status.js.map

package/dist/types/run/status.js.map

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

package/dist/types/session/ids.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Session hierarchy branded ID re-export barrel.
+ *
+ * Canonical definitions live in `../ids/index.ts`. This barrel exists solely
+ * for ergonomic co-location with session-scoped callers (they already import
+ * from `types/session/`).
+ */
+export type { ProjectId, ThreadId, SubSessionId, HandoffId, WorkspaceId, SummaryId, DeliverableId, SessionId, TenantId, RunId, AgentId, UserId, TaskId, } from '../ids/index.js';
+//# sourceMappingURL=ids.d.ts.map

package/dist/types/session/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../../src/types/session/ids.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACX,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,WAAW,EACX,SAAS,EACT,aAAa,EACb,SAAS,EACT,QAAQ,EACR,KAAK,EACL,OAAO,EACP,MAAM,EACN,MAAM,GACN,MAAM,iBAAiB,CAAA"}

package/dist/types/session/ids.js

@@ -0,0 +1,9 @@
+/**
+ * Session hierarchy branded ID re-export barrel.
+ *
+ * Canonical definitions live in `../ids/index.ts`. This barrel exists solely
+ * for ergonomic co-location with session-scoped callers (they already import
+ * from `types/session/`).
+ */
+export {};
+//# sourceMappingURL=ids.js.map

package/dist/types/session/ids.js.map

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

package/dist/types/session/index.d.ts

@@ -0,0 +1,3 @@
+export type { ProjectId, ThreadId, SubSessionId, HandoffId, WorkspaceId, SummaryId, DeliverableId, SessionId, TenantId, RunId, AgentId, UserId, TaskId, } from './ids.js';
+export type { SessionStore, SessionView, CreateProjectParams, CreateSessionParams, CreateSubSessionParams, } from './store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/session/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACX,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,WAAW,EACX,SAAS,EACT,aAAa,EACb,SAAS,EACT,QAAQ,EACR,KAAK,EACL,OAAO,EACP,MAAM,EACN,MAAM,GACN,MAAM,UAAU,CAAA;AAEjB,YAAY,EACX,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,GACtB,MAAM,YAAY,CAAA"}

package/dist/types/session/index.js

@@ -0,0 +1,5 @@
+// Sub-barrel for session-hierarchy type surface.
+// Concrete definitions live in sibling files; re-export them here so other
+// modules import via `../types/session/index.js`.
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/session/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,2EAA2E;AAC3E,kDAAkD"}

package/dist/types/session/store.d.ts

@@ -0,0 +1,210 @@
+/**
+ * SessionStore — canonical persistence contract for the session hierarchy.
+ *
+ * Every accessor takes explicit {@link TenantId} (Convention #17). Cross-tenant
+ * access rejects with `TenantIsolationError`. Convention #0: no speculative
+ * API — extensions land alongside their consumers.
+ */
+import type { ActorRef } from '../../session/hierarchy/actor.js';
+import type { Project } from '../../session/hierarchy/project.js';
+import type { Session } from '../../session/hierarchy/session.js';
+import type { CompletionMode, FailureMode, SubSession, SubSessionKind } from '../../session/hierarchy/sub-session.js';
+import type { SessionSummaryRef } from '../../session/summary/ref.js';
+import type { SessionMessage } from '../../store/session/messages.js';
+import type { MessageId, SessionId, TenantId } from '../ids/index.js';
+import type { Message } from '../message/index.js';
+import type { ProjectId, SubSessionId, SummaryId, ThreadId } from '../session/ids.js';
+/**
+ * Params for {@link SessionStore.createSession}. The store owns id generation,
+ * `ownerVersion` initialization, and timestamps.
+ *
+ * Both `threadId` and `projectId` are required. `projectId` must equal the
+ * `projectId` of the thread identified by `threadId`; the store does NOT
+ * perform that cross-store consistency check (it has no ThreadStore handle
+ * by design — see the store-boundary rationale in {@link ThreadStore}). The
+ * caller is the authority; typically spawn and handoff paths copy both from
+ * a freshly-loaded `Thread` record or from their own context which already
+ * tracks both.
+ */
+export interface CreateSessionParams {
+    threadId: ThreadId;
+    projectId: ProjectId;
+    /**
+     * Initial owner of the session. May be `null` for bootstrap scenarios where
+     * the first Run attaches an actor; the store rejects mutations against
+     * actor-less sessions from downstream consumers.
+     */
+    currentActor: ActorRef | null;
+}
+/**
+ * Params for {@link SessionStore.createSubSession}. `workspaceId` is optional
+ * because Phase 3 does not yet wire workspace creation into spawn — Phase 6
+ * makes the two atomic. `summaryRef` is populated by the materializer in
+ * Phase 5, never by callers of this API.
+ */
+export interface CreateSubSessionParams {
+    parentSessionId: SessionId;
+    childSessionId: SessionId;
+    kind: SubSessionKind;
+    spawnedBy: ActorRef;
+    failureMode?: FailureMode;
+    completionMode?: CompletionMode;
+}
+/**
+ * Minimal Project surface needed by the store in Phase 3. The full Project
+ * entity lives in `session/hierarchy/project.ts`; a dedicated `ProjectStore`
+ * is out of scope for this phase (session-hierarchy.md §11 defers the project
+ * store to a later phase).
+ */
+export interface CreateProjectParams {
+    tenantId: TenantId;
+    name: string;
+}
+/**
+ * Return shape for {@link SessionStore.drill}. See session-hierarchy.md §14.3.
+ * The fields are final — consumers may rely on exhaustiveness (Convention #6).
+ *
+ * `ancestry` is root-to-self. `children` lists direct sub-sessions only
+ * (recursive drill-down is the consumer's responsibility).
+ */
+export interface SessionView {
+    session: Session;
+    children: readonly SubSession[];
+    ancestry: readonly SessionId[];
+}
+/**
+ * Canonical persistence contract. Every accessor takes explicit `tenantId`.
+ * Cross-tenant reads/writes must reject with `TenantIsolationError`
+ * (see `session/errors.ts`).
+ *
+ * Read accessors return `null` when the resource does not exist for the
+ * supplied tenant — this is the deny-by-default surface (Convention #5):
+ * callers never get a fallback and must branch on missing explicitly.
+ */
+export interface SessionStore {
+    createProject(params: CreateProjectParams, tenantId: TenantId): Promise<Project>;
+    getProject(projectId: ProjectId, tenantId: TenantId): Promise<Project | null>;
+    createSession(params: CreateSessionParams, tenantId: TenantId): Promise<Session>;
+    getSession(sessionId: SessionId, tenantId: TenantId): Promise<Session | null>;
+    updateSession(session: Session, tenantId: TenantId): Promise<void>;
+    /**
+     * List every Session that belongs to the given Thread for the caller's
+     * tenant, ordered by `createdAt` ascending. Returns an empty array when
+     * none exist.
+     *
+     * Thread-scoped queries rely on `session.threadId` (set at creation, never
+     * rewritten). Cross-tenant sessions that happen to share the supplied
+     * `threadId` are silently skipped — the listing is tenant-scoped, not an
+     * isolation violation (the caller did not request a specific record).
+     *
+     * Exists to back ThreadManager's archival + delete preconditions
+     * ({@link import('../../manager/thread/lifecycle.js').ThreadManager.archive}
+     * rejects when any session is in a non-terminal state; `delete` rejects
+     * while any session still references the thread). Keeping this primitive
+     * on {@link SessionStore} preserves the store-ownership boundary —
+     * ThreadStore stays unaware of session layout (Convention #0).
+     */
+    listSessions(threadId: ThreadId, tenantId: TenantId): Promise<readonly Session[]>;
+    /**
+     * Hard-delete a session. Idempotent — absent sessions succeed as a no-op.
+     * Rejects with `TenantIsolationError` on cross-tenant access.
+     *
+     * Closes the Phase 4 Known Delta (broadcast rollback previously had to
+     * flip status to `'archived'` as a stopgap). Used by:
+     *   - Broadcast rollback (compensating cleanup — pattern doc §6.2)
+     *   - Archival tombstone consolidation when a caller prefers deletion
+     *     over the in-slot tombstone (uncommon — default is in-slot).
+     *
+     * Policy: rejects when the session still has sub-sessions attached —
+     * callers must delete children first. This keeps the operation a single,
+     * locally-reasoning write rather than an implicit recursive cascade
+     * (Convention #5 deny-by-default).
+     */
+    deleteSession(sessionId: SessionId, tenantId: TenantId): Promise<void>;
+    createSubSession(params: CreateSubSessionParams, tenantId: TenantId): Promise<SubSession>;
+    getSubSession(subSessionId: SubSessionId, tenantId: TenantId): Promise<SubSession | null>;
+    updateSubSession(subSession: SubSession, tenantId: TenantId): Promise<void>;
+    /**
+     * Hard-delete a sub-session record. Idempotent — absent sub-sessions
+     * succeed as a no-op. Rejects with `TenantIsolationError` on cross-tenant
+     * access. Does not cascade to the owned child session; the caller owns
+     * that (typical broadcast-rollback flow deletes the sub-session first,
+     * then the child session).
+     */
+    deleteSubSession(subSessionId: SubSessionId, tenantId: TenantId): Promise<void>;
+    /**
+     * Append a single message to the session's message log. Returns the
+     * assigned {@link MessageId}. Write is append-only; the store never
+     * rewrites or reorders previously persisted messages.
+     */
+    appendMessage(sessionId: SessionId, message: Message, tenantId: TenantId): Promise<MessageId>;
+    /**
+     * Load the full message history for a session in insertion order.
+     * Returns an empty array when the session has no messages.
+     *
+     * Returns payload-only {@link Message} records. Callers that need the
+     * full persistence envelope (including {@link MessageId} and timestamp)
+     * should use {@link SessionStore.loadSessionMessages} instead.
+     */
+    loadMessages(sessionId: SessionId, tenantId: TenantId): Promise<readonly Message[]>;
+    /**
+     * Load the full {@link SessionMessage} envelope for every persisted
+     * message in insertion order (Phase 9 Known Delta #7). Unlike
+     * {@link SessionStore.loadMessages} this preserves the original
+     * {@link MessageId} and timestamp — required for full-fidelity archival
+     * round-trips via {@link ArchivalManager.archive}.
+     *
+     * Returns an empty array when the session has no messages; cross-tenant
+     * reads reject with `TenantIsolationError` (Convention #17).
+     */
+    loadSessionMessages(sessionId: SessionId, tenantId: TenantId): Promise<readonly SessionMessage[]>;
+    /**
+     * Direct children of the session (one level). Returns an empty array when
+     * the session has no delegations.
+     */
+    getChildren(sessionId: SessionId, tenantId: TenantId): Promise<readonly SubSession[]>;
+    /**
+     * Session id chain from root to self, inclusive. Walks parent sub-session
+     * links. Rejects on cycle via `session/errors.ts#AncestryCycleError` —
+     * the write path enforces acyclicity, so a cycle here indicates store
+     * corruption.
+     */
+    getAncestry(sessionId: SessionId, tenantId: TenantId): Promise<readonly SessionId[]>;
+    /**
+     * Single-round navigation primitive. Returns `null` when the session does
+     * not exist for the tenant. See session-hierarchy.md §14.3.
+     */
+    drill(sessionId: SessionId, tenantId: TenantId): Promise<SessionView | null>;
+    /**
+     * @internal Kernel-internal. Call through
+     * `SessionSummaryMaterializer.materialize`, never directly. The
+     * `materializedBy: 'kernel'` constraint on the argument type ensures
+     * external callers cannot construct a valid input — the only mint site for
+     * `SummaryId` is `generateSummaryId` inside the Materializer.
+     *
+     * Atomic write-then-status-flip (Convention #8): persists the summary and
+     * transitions the owning Session's status to `'idle'` if it was in a
+     * non-terminal state (`'active' | 'locked' | 'awaiting_merge'`). The two
+     * writes commit as one logical unit; mid-crash recovery is replay via
+     * `SessionSummaryMaterializer.recover()`.
+     *
+     * Rejects with {@link SessionAlreadySummarizedError} if a summary already
+     * exists for the session (re-materialization forbidden; see
+     * session-hierarchy.md §4.7 immutability invariant).
+     */
+    recordSummary(summary: SessionSummaryRef & {
+        materializedBy: 'kernel';
+    }, tenantId: TenantId): Promise<void>;
+    /**
+     * Loads the persisted summary for a session. Returns `null` when none has
+     * been materialized. Cross-tenant reads reject with `TenantIsolationError`
+     * (Convention #17).
+     */
+    getSummary(sessionId: SessionId, tenantId: TenantId): Promise<SessionSummaryRef | null>;
+}
+/**
+ * Re-export of {@link SummaryId} so downstream consumers importing from
+ * `types/session/store.js` pick up the brand alongside the store contract.
+ */
+export type { SummaryId };
+//# sourceMappingURL=store.d.ts.map

package/dist/types/session/store.d.ts.map

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

package/dist/types/session/store.js

@@ -0,0 +1,9 @@
+/**
+ * SessionStore — canonical persistence contract for the session hierarchy.
+ *
+ * Every accessor takes explicit {@link TenantId} (Convention #17). Cross-tenant
+ * access rejects with `TenantIsolationError`. Convention #0: no speculative
+ * API — extensions land alongside their consumers.
+ */
+export {};
+//# sourceMappingURL=store.js.map

package/dist/types/session/store.js.map

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

package/dist/types/thread/index.d.ts

@@ -0,0 +1,2 @@
+export type { ThreadStore, CreateThreadParams } from './store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/thread/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/thread/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA"}

package/dist/types/thread/index.js

@@ -0,0 +1,5 @@
+// Sub-barrel for the Thread type surface (Convention #4).
+// Concrete types live in sibling files; re-export them here so consumers
+// import via `../types/thread/index.js`.
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/thread/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/thread/index.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,yEAAyE;AACzE,yCAAyC"}

package/dist/types/thread/store.d.ts

@@ -0,0 +1,86 @@
+/**
+ * ThreadStore — canonical persistence contract for the Thread topic layer
+ * (Project → **Thread** → Session → SubSession → Run).
+ *
+ * Threads are pure containers (Phase 0 decision B.1). They have no own
+ * message stream and no fan-in `deriveStatus()` — status is owner-managed
+ * (`'open' | 'archived'`). Every accessor takes explicit {@link TenantId};
+ * cross-tenant access rejects with `TenantIsolationError` (Convention #17).
+ *
+ * Read accessors return `null` when the resource does not exist for the
+ * supplied tenant (deny-by-default surface). Callers branch on missing
+ * explicitly — no fallback substitution.
+ *
+ * `deleteThread` is intentionally a dumb record-delete at this layer:
+ * it does NOT walk session ownership. The "reject when sessions attached"
+ * precondition lives in {@link import('../../manager/thread/lifecycle.js').ThreadManager}
+ * where both stores are in scope. Keeping ThreadStore free of cross-store
+ * awareness preserves the single-boundary ownership boundary that Phase 2
+ * has just introduced for this layer (Convention #0).
+ */
+import type { Thread } from '../../session/hierarchy/thread.js';
+import type { TenantId } from '../ids/index.js';
+import type { ProjectId, ThreadId } from '../session/ids.js';
+/**
+ * Params for {@link ThreadStore.createThread}. The store owns id generation,
+ * `ownerVersion` initialization (0 at create), and timestamps.
+ */
+export interface CreateThreadParams {
+    projectId: ProjectId;
+    /**
+     * User-facing display label. Not unique within the project — see
+     * {@link Thread} JSDoc. Empty strings are permitted; callers that require
+     * a label should validate at the API layer.
+     */
+    title: string;
+}
+/**
+ * Canonical persistence contract for the Thread layer. Every accessor takes
+ * explicit `tenantId`; cross-tenant reads/writes reject with
+ * `TenantIsolationError` (`session/errors.ts`, Convention #17).
+ */
+export interface ThreadStore {
+    /**
+     * Persist a new Thread under the given project. Returns the minted
+     * {@link Thread} with `ownerVersion: 0` and freshly-generated
+     * {@link ThreadId}. Callers must ensure the parent project exists and
+     * belongs to the same tenant — the store does not validate project
+     * ownership (that is a cross-store precondition owned by the manager).
+     */
+    createThread(params: CreateThreadParams, tenantId: TenantId): Promise<Thread>;
+    /**
+     * Read a Thread by id. Returns `null` when absent. Cross-tenant reads
+     * reject with `TenantIsolationError`.
+     */
+    getThread(threadId: ThreadId, tenantId: TenantId): Promise<Thread | null>;
+    /**
+     * Persist a mutation to a Thread record. CAS on `ownerVersion`: if the
+     * supplied `thread.ownerVersion` does not match the persisted version,
+     * rejects with `StaleThreadError`. On success the write commits with
+     * `ownerVersion + 1` and a refreshed `updatedAt`.
+     *
+     * Archival transition (`status: 'open' → 'archived'`) shares this path;
+     * the caller is responsible for verifying that no non-terminal Sessions
+     * are attached before flipping (see ThreadManager.archiveThread).
+     */
+    updateThread(thread: Thread, tenantId: TenantId): Promise<void>;
+    /**
+     * Hard-delete a Thread record. Idempotent — absent threads succeed as a
+     * no-op. Rejects with `TenantIsolationError` on cross-tenant access.
+     *
+     * **Does NOT cascade to child Sessions** — the caller (typically
+     * ThreadManager) enforces the precondition that no Sessions reference
+     * this thread. Convention #5: deny-by-default, no implicit cascade.
+     */
+    deleteThread(threadId: ThreadId, tenantId: TenantId): Promise<void>;
+    /**
+     * List all Threads under a project for the given tenant, ordered by
+     * `createdAt` ascending. Returns an empty array when none exist.
+     * Cross-tenant reads reject with `TenantIsolationError`.
+     *
+     * The return shape is a concrete snapshot — callers that mutate the
+     * result array do not affect store state.
+     */
+    listThreads(projectId: ProjectId, tenantId: TenantId): Promise<readonly Thread[]>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/types/thread/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/types/thread/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAA;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAE5D;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAClC,SAAS,EAAE,SAAS,CAAA;IACpB;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAA;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC3B;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAE7E;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAEzE;;;;;;;;;OASG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE/D;;;;;;;OAOG;IACH,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnE;;;;;;;OAOG;IACH,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAA;CACjF"}

package/dist/types/thread/store.js

@@ -0,0 +1,22 @@
+/**
+ * ThreadStore — canonical persistence contract for the Thread topic layer
+ * (Project → **Thread** → Session → SubSession → Run).
+ *
+ * Threads are pure containers (Phase 0 decision B.1). They have no own
+ * message stream and no fan-in `deriveStatus()` — status is owner-managed
+ * (`'open' | 'archived'`). Every accessor takes explicit {@link TenantId};
+ * cross-tenant access rejects with `TenantIsolationError` (Convention #17).
+ *
+ * Read accessors return `null` when the resource does not exist for the
+ * supplied tenant (deny-by-default surface). Callers branch on missing
+ * explicitly — no fallback substitution.
+ *
+ * `deleteThread` is intentionally a dumb record-delete at this layer:
+ * it does NOT walk session ownership. The "reject when sessions attached"
+ * precondition lives in {@link import('../../manager/thread/lifecycle.js').ThreadManager}
+ * where both stores are in scope. Keeping ThreadStore free of cross-store
+ * awareness preserves the single-boundary ownership boundary that Phase 2
+ * has just introduced for this layer (Convention #0).
+ */
+export {};
+//# sourceMappingURL=store.js.map

package/dist/types/thread/store.js.map

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

package/dist/utils/id.d.ts

@@ -1,4 +1,5 @@
-import type { ActivityId, AdvisoryCallId, AdvisoryId, CheckpointId, ChunkId, ConnectorId, ConnectorInstanceId, CredentialId, DocumentId, EmergencySaveId, EnvironmentId, ExecutionContextId, KnowledgeBaseId, MCPClientId, MCPServerId, MCPSessionId, MemoryId, MessageId, PlanId, PluginId, RunId, SandboxId, SessionId, TaskId, TenantId, ThreadId, ToolCallId } from '../types/ids/index.js';
+import type { ActivityId, AdvisoryCallId, AdvisoryId, CheckpointId, ChunkId, ConnectorId, ConnectorInstanceId, CredentialId, DeliverableId, DocumentId, EmergencySaveId, EnvironmentId, ExecutionContextId, HandoffId, KnowledgeBaseId, MCPClientId, MCPServerId, MCPSessionId, MemoryId, MessageId, PlanId, PluginId, ProjectId, RunId, SandboxId, SessionId, SubSessionId, SummaryId, TaskId, TenantId, ThreadId, ToolCallId, WorkspaceId } from '../types/ids/index.js';
+export declare function generateProjectId(): ProjectId;
 export declare function generateThreadId(): ThreadId;
 export declare function generateRunId(): RunId;
 export declare function generateMessageId(): MessageId;
@@ -26,7 +27,12 @@ export declare function generateEmergencySaveId(): EmergencySaveId;
 export declare function generateMemoryId(): MemoryId;
 export declare function generatePluginId(): PluginId;
 export declare function generateSandboxId(): SandboxId;
-export declare function parseThreadId(raw: string): ThreadId;
+export declare function generateWorkspaceId(): WorkspaceId;
+export declare function generateSubSessionId(): SubSessionId;
+export declare function generateSummaryId(): SummaryId;
+export declare function generateHandoffId(): HandoffId;
+export declare function generateDeliverableId(): DeliverableId;
+export declare function parseProjectId(raw: string): ProjectId;
 export declare function parseRunId(raw: string): RunId;
 export declare function parseConnectorInstanceId(raw: string): ConnectorInstanceId;
 export declare function parsePluginId(raw: string): PluginId;

package/dist/utils/id.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,UAAU,EACV,cAAc,EACd,UAAU,EACV,YAAY,EACZ,OAAO,EACP,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,MAAM,EACN,QAAQ,EACR,KAAK,EACL,SAAS,EACT,SAAS,EACT,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,MAAM,uBAAuB,CAAA;AAsB9B,wBAAgB,gBAAgB,IAAI,QAAQ,CAE3C;AAED,wBAAgB,aAAa,IAAI,KAAK,CAErC;AAED,wBAAgB,iBAAiB,IAAI,SAAS,CAE7C;AAED,wBAAgB,iBAAiB,IAAI,SAAS,CAE7C;AAED,wBAAgB,kBAAkB,IAAI,UAAU,CAE/C;AAED,wBAAgB,kBAAkB,IAAI,UAAU,CAE/C;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,uBAAuB,IAAI,eAAe,CAEzD;AAED,wBAAgB,kBAAkB,IAAI,UAAU,CAE/C;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED,wBAAgB,mBAAmB,IAAI,WAAW,CAEjD;AAED,wBAAgB,2BAA2B,IAAI,mBAAmB,CAEjE;AAED,wBAAgB,gBAAgB,IAAI,QAAQ,CAE3C;AAED,wBAAgB,oBAAoB,IAAI,YAAY,CAEnD;AAED,wBAAgB,0BAA0B,IAAI,kBAAkB,CAE/D;AAED,wBAAgB,mBAAmB,IAAI,WAAW,CAEjD;AAED,wBAAgB,mBAAmB,IAAI,WAAW,CAEjD;AAED,wBAAgB,oBAAoB,IAAI,YAAY,CAEnD;AAED,wBAAgB,qBAAqB,IAAI,aAAa,CAErD;AAED,wBAAgB,oBAAoB,IAAI,YAAY,CAEnD;AAED,wBAAgB,kBAAkB,IAAI,UAAU,CAE/C;AAED,wBAAgB,sBAAsB,IAAI,cAAc,CAEvD;AAED,wBAAgB,uBAAuB,IAAI,eAAe,CAEzD;AAED,wBAAgB,gBAAgB,IAAI,QAAQ,CAE3C;AAED,wBAAgB,gBAAgB,IAAI,QAAQ,CAE3C;AAED,wBAAgB,iBAAiB,IAAI,SAAS,CAE7C;AASD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAEnD;AACD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAE7C;AACD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAEzE;AACD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAEnD;AACD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAErD"}
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,UAAU,EACV,cAAc,EACd,UAAU,EACV,YAAY,EACZ,OAAO,EACP,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,UAAU,EACV,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,SAAS,EACT,eAAe,EACf,WAAW,EACX,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,MAAM,EACN,QAAQ,EACR,SAAS,EACT,KAAK,EACL,SAAS,EACT,SAAS,EACT,YAAY,EACZ,SAAS,EACT,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,WAAW,EACX,MAAM,uBAAuB,CAAA;AAsB9B,wBAAgB,iBAAiB,IAAI,SAAS,CAE7C;AAED,wBAAgB,gBAAgB,IAAI,QAAQ,CAE3C;AAED,wBAAgB,aAAa,IAAI,KAAK,CAErC;AAED,wBAAgB,iBAAiB,IAAI,SAAS,CAE7C;AAED,wBAAgB,iBAAiB,IAAI,SAAS,CAE7C;AAED,wBAAgB,kBAAkB,IAAI,UAAU,CAE/C;AAED,wBAAgB,kBAAkB,IAAI,UAAU,CAE/C;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,uBAAuB,IAAI,eAAe,CAEzD;AAED,wBAAgB,kBAAkB,IAAI,UAAU,CAE/C;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED,wBAAgB,mBAAmB,IAAI,WAAW,CAEjD;AAED,wBAAgB,2BAA2B,IAAI,mBAAmB,CAEjE;AAED,wBAAgB,gBAAgB,IAAI,QAAQ,CAE3C;AAED,wBAAgB,oBAAoB,IAAI,YAAY,CAEnD;AAED,wBAAgB,0BAA0B,IAAI,kBAAkB,CAE/D;AAED,wBAAgB,mBAAmB,IAAI,WAAW,CAEjD;AAED,wBAAgB,mBAAmB,IAAI,WAAW,CAEjD;AAED,wBAAgB,oBAAoB,IAAI,YAAY,CAEnD;AAED,wBAAgB,qBAAqB,IAAI,aAAa,CAErD;AAED,wBAAgB,oBAAoB,IAAI,YAAY,CAEnD;AAED,wBAAgB,kBAAkB,IAAI,UAAU,CAE/C;AAED,wBAAgB,sBAAsB,IAAI,cAAc,CAEvD;AAED,wBAAgB,uBAAuB,IAAI,eAAe,CAEzD;AAED,wBAAgB,gBAAgB,IAAI,QAAQ,CAE3C;AAED,wBAAgB,gBAAgB,IAAI,QAAQ,CAE3C;AAED,wBAAgB,iBAAiB,IAAI,SAAS,CAE7C;AAED,wBAAgB,mBAAmB,IAAI,WAAW,CAEjD;AAED,wBAAgB,oBAAoB,IAAI,YAAY,CAEnD;AAED,wBAAgB,iBAAiB,IAAI,SAAS,CAE7C;AAED,wBAAgB,iBAAiB,IAAI,SAAS,CAE7C;AAED,wBAAgB,qBAAqB,IAAI,aAAa,CAErD;AASD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAErD;AACD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAE7C;AACD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAEzE;AACD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAEnD;AACD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAErD"}

package/dist/utils/id.js

@@ -18,6 +18,9 @@ function generateId(prefix, length = 12) {
     }
     return `${prefix}${suffix}`;
 }
+export function generateProjectId() {
+    return generateId('prj_');
+}
 export function generateThreadId() {
     return generateId('thd_');
 }
@@ -28,7 +31,7 @@ export function generateMessageId() {
     return generateId('msg_');
 }
 export function generateSessionId() {
-    return generateId('sess_');
+    return generateId('ses_');
 }
 export function generateToolCallId() {
     return generateId('call_', 8);
@@ -58,7 +61,7 @@ export function generateConnectorInstanceId() {
     return generateId('ci_');
 }
 export function generateTenantId() {
-    return generateId('ten_');
+    return generateId('tnt_');
 }
 export function generateCredentialId() {
     return generateId('cred_');
@@ -99,14 +102,29 @@ export function generatePluginId() {
 export function generateSandboxId() {
     return generateId('sbx_');
 }
+export function generateWorkspaceId() {
+    return generateId('wsp_');
+}
+export function generateSubSessionId() {
+    return generateId('sub_');
+}
+export function generateSummaryId() {
+    return generateId('sum_');
+}
+export function generateHandoffId() {
+    return generateId('hof_');
+}
+export function generateDeliverableId() {
+    return generateId('del_');
+}
 function parseId(raw, prefix, typeName) {
     if (!raw.startsWith(prefix)) {
         throw new Error(`Invalid ${typeName}: expected "${prefix}" prefix, got "${raw}"`);
     }
     return raw;
 }
-export function parseThreadId(raw) {
-    return parseId(raw, 'thd_', 'ThreadId');
+export function parseProjectId(raw) {
+    return parseId(raw, 'prj_', 'ProjectId');
 }
 export function parseRunId(raw) {
     return parseId(raw, 'run_', 'RunId');

package/dist/utils/id.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@namzu/sdk",
-  "version": "0.1.8",
+  "version": "0.3.0",
   "description": "Open-source AI agent SDK with a built-in runtime. Nothing between you and your agents.",
   "license": "FSL-1.1-MIT",
   "type": "module",
@@ -16,8 +16,8 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     }
   },
   "files": [
@@ -49,6 +49,7 @@
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
     "@types/node": "^22.19.17",
+    "knip": "^6.4.1",
     "typescript": "^5.5.0",
     "vitest": "^2.0.0"
   },
@@ -60,13 +61,7 @@
     "format": "biome format --write src/",
     "test": "vitest run --passWithNoTests",
     "typecheck": "tsc --noEmit",
-    "verify": "bash scripts/verify.sh",
-    "release:patch": "bash scripts/release.sh patch",
-    "release:minor": "bash scripts/release.sh minor",
-    "release:major": "bash scripts/release.sh major",
-    "release:rc": "bash scripts/release.sh rc",
-    "release:beta": "bash scripts/release.sh beta",
-    "release:stable": "bash scripts/release.sh stable",
-    "release:dry": "bash scripts/release.sh patch --dry-run"
+    "knip": "knip",
+    "knip:production": "knip --production"
   }
 }

package/src/agents/ReactiveAgent.ts

@@ -32,8 +32,10 @@ export class ReactiveAgent extends AbstractAgent<ReactiveAgentConfig, ReactiveAg
 	): Promise<ReactiveAgentResult> {
 		const startTime = Date.now()
 
-		if (!config.threadId) {
-			throw new Error('ReactiveAgent.run requires a threadId in config')
+		if (!config.sessionId || !config.threadId || !config.projectId || !config.tenantId) {
+			throw new Error(
+				'ReactiveAgent requires sessionId, threadId, projectId, and tenantId in config (session-hierarchy.md §12.1).',
+			)
 		}
 
 		const run = await drainQuery(
@@ -58,7 +60,10 @@ export class ReactiveAgent extends AbstractAgent<ReactiveAgentConfig, ReactiveAg
 				agentId: this.metadata.id,
 				agentName: this.metadata.name,
 				workingDirectory: input.workingDirectory,
+				sessionId: config.sessionId,
 				threadId: config.threadId,
+				projectId: config.projectId,
+				tenantId: config.tenantId,
 				parentRunId: config.parentRunId,
 				depth: config.depth,
 				contextLevel: config.contextLevel,