@hy-sde-org/dsh-pi-durable 0.2.0-rc.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hy-sde
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/cordis.patch.yml

@@ -0,0 +1,30 @@
+# @hy-sde-org/dsh-pi-durable — the durable-agent engine, delivered as ONE
+# self-contained host-plane row.
+#
+# The plugin publishes the `piDurableAgent` service (a Harness over
+# ~/.dsh/storages/pi-agent.sqlite with an OpenAI-compatible relay provider).
+# It injects nothing from the host: pi-durable owns its storage medium, so the
+# row sits at HOST plane (a durable process-wide service), not inside a preset.
+# The model-facing tools live in @hy-sde-org/dsh-tool-pi-durable and resolve
+# this service by name from any agent preset.
+#
+# All row ids carry the `hy-sde-` prefix to avoid clashing with any shipped
+# row of the same name (a duplicate loader id fails the boot).
+#
+# `baseUrl` left unset starts the engine in WRITE-ONLY mode: durable writes,
+# documents, and tasks work, but `input` submissions fail with a config error
+# naming this knob. Point `baseUrl` at any OpenAI-compatible endpoint and set
+# `apiKeyEnv` (default PI_DURABLE_API_KEY) to enable generation.
+#
+# Override per deployment by patching the row by id:
+#
+#   - id: hy-sde-pi-durable
+#     config:
+#       path: /var/lib/dsh/pi-agent.sqlite
+#       baseUrl: https://relay.internal/v1
+#       apiKeyEnv: MY_RELAY_KEY
+#       modelId: my-model
+- insert:
+    - id: hy-sde-pi-durable
+      name: '@hy-sde-org/dsh-pi-durable'
+      config: {}

package/dist/agent.d.ts

@@ -0,0 +1,74 @@
+/**
+ * The durable-agent runtime: one pi-durable {@link Harness} over SQLite
+ * storage with the relay provider registered, plus the narrow facade the
+ * model-facing tools consume. The harness opens eagerly on construction
+ * (failures surface to every caller) and the root conversation is created
+ * idempotently on first use, so a host restart resumes in place.
+ * @module
+ */
+import { type JsonValue } from '@earendil-works/chord';
+import { type Cursor, type EntryRecord, type HarnessInspection, type Page, type SubmissionRecord } from '@earendil-works/pi-durable';
+import type { ResolvedPiDurableConfig } from './config.ts';
+/** Result of admitting one root submission. */
+export interface RootSubmissionOutcome {
+    readonly submissionId: string;
+    readonly record: SubmissionRecord;
+}
+/** Point-in-time status of the engine. */
+export interface PiDurableStatus {
+    readonly rootConversationId: string;
+    readonly inspection: HarnessInspection;
+    readonly generationConfigured: boolean;
+}
+/**
+ * The engine facade published under the `piDurableAgent` service key.
+ * Every method awaits the eager open, so a failed init rejects loudly at
+ * call time with the original error.
+ */
+export declare class PiDurableAgent {
+    private readonly config;
+    private readonly openPromise;
+    private harness;
+    private rootPromise;
+    constructor(config: ResolvedPiDurableConfig);
+    private open;
+    /** Resolves once the harness is open; rejections carry the init error. */
+    ready(): Promise<void>;
+    private harnessOf;
+    private root;
+    private openRoot;
+    private findExistingRoot;
+    private assertGenerationConfigured;
+    /**
+     * Submit user input to the root conversation. Exactly-once per `requestId`
+     * (scoped to the conversation); the run continues in the background.
+     */
+    submitInput(input: string, options?: {
+        requestId?: string;
+        whenBusy?: 'steer' | 'followUp' | 'reject';
+    }): Promise<RootSubmissionOutcome>;
+    /**
+     * Admit a passive entry write to the root conversation — durable
+     * bookkeeping that never triggers a generation run.
+     */
+    writeEntry(kind: string, data: JsonValue, requestId?: string): Promise<RootSubmissionOutcome>;
+    /** Resolve one submission record by id (undefined when unknown). */
+    submissionRecord(id: string): Promise<SubmissionRecord | undefined>;
+    /** Newest-first fork-aware page of the root conversation's history. */
+    history(limit: number, cursor?: Cursor): Promise<Page<EntryRecord, Cursor>>;
+    /** Newest-first page of any conversation's history (used for forks). */
+    historyOf(conversationId: string, limit: number, cursor?: Cursor): Promise<Page<EntryRecord, Cursor>>;
+    /** Fork the root conversation at an entry; history up to `entryId` is inherited. */
+    forkFrom(entryId: string, options?: {
+        instructions?: string;
+    }): Promise<{
+        conversationId: string;
+    }>;
+    /** Abort the root conversation's ordinary scope and resolve when idle. */
+    abortRoot(): Promise<void>;
+    /** Point-in-time status of the engine. */
+    status(): Promise<PiDurableStatus>;
+    /** Seal admission, settle commits, close storage. Idempotent. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAGtD,OAAO,EAML,KAAK,MAAM,EAEX,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,IAAI,EAIT,KAAK,gBAAgB,EAEtB,MAAM,4BAA4B,CAAA;AAInC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAG1D,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;CAClC;AAED,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAA;IACtC,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAA;CACvC;AAID;;;;GAIG;AACH,qBAAa,cAAc;IAKb,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAe;IAC3C,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,WAAW,CAAmC;gBAEzB,MAAM,EAAE,uBAAuB;YAI9C,IAAI;IAelB,0EAA0E;IACpE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAId,SAAS;YAOT,IAAI;YAMJ,QAAQ;YAcR,gBAAgB;IAQ9B,OAAO,CAAC,0BAA0B;IASlC;;;OAGG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAA;KAAO,GAC/E,OAAO,CAAC,qBAAqB,CAAC;IAcjC;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAYnG,oEAAoE;IAC9D,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAOzE,uEAAuE;IACjE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAKjF,wEAAwE;IAClE,SAAS,CACb,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IASrC,oFAAoF;IAC9E,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAS7G,0EAA0E;IACpE,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAKhC,0CAA0C;IACpC,MAAM,IAAI,OAAO,CAAC,eAAe,CAAC;IAWxC,iEAAiE;IAC3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAa7B"}

package/dist/agent.js

@@ -0,0 +1,190 @@
+/**
+ * The durable-agent runtime: one pi-durable {@link Harness} over SQLite
+ * storage with the relay provider registered, plus the narrow facade the
+ * model-facing tools consume. The harness opens eagerly on construction
+ * (failures surface to every caller) and the root conversation is created
+ * idempotently on first use, so a host restart resumes in place.
+ * @module
+ */
+import { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';
+import { createModels } from '@earendil-works/pi-ai';
+import { createRegistry, Harness, ROOT_CONVERSATION_ID, } from '@earendil-works/pi-durable';
+import { CodingTools } from '@earendil-works/pi-durable/tools';
+import { openNodeSqliteStorage } from '@earendil-works/pi-durable/storage/sqlite/node';
+import { NodeExecutionEnv } from '@earendil-works/pi-durable/env/node';
+import { createRelayProvider } from "./provider.js";
+const BUSY_TIMEOUT_MS = 5_000;
+/**
+ * The engine facade published under the `piDurableAgent` service key.
+ * Every method awaits the eager open, so a failed init rejects loudly at
+ * call time with the original error.
+ */
+export class PiDurableAgent {
+    config;
+    openPromise;
+    harness;
+    rootPromise;
+    constructor(config) {
+        this.config = config;
+        this.openPromise = this.open();
+    }
+    async open() {
+        const storage = await openNodeSqliteStorage(this.config.path, { busyTimeoutMs: BUSY_TIMEOUT_MS });
+        const models = createModels();
+        if (this.config.baseUrl !== undefined) {
+            models.setProvider(createRelayProvider(this.config));
+        }
+        const harness = await Harness.open(storage, {
+            models,
+            registry: createEngineRegistry(),
+            env: (target) => new NodeExecutionEnv({ cwd: target.cwd ?? this.config.cwd }),
+        }, BACKGROUND_CONTEXT);
+        this.harness = harness;
+        await harness.resume();
+    }
+    /** Resolves once the harness is open; rejections carry the init error. */
+    async ready() {
+        await this.openPromise;
+    }
+    async harnessOf() {
+        await this.openPromise;
+        const harness = this.harness;
+        if (harness === undefined)
+            throw new Error('[pi-durable] harness failed to open');
+        return harness;
+    }
+    async root() {
+        const harness = await this.harnessOf();
+        this.rootPromise ??= this.openRoot(harness);
+        return await this.rootPromise;
+    }
+    async openRoot(harness) {
+        const existing = await this.findExistingRoot(harness);
+        if (existing !== undefined)
+            return existing;
+        const agent = {
+            extensions: [CodingTools],
+            ...(this.config.baseUrl !== undefined
+                ? { model: { provider: this.config.providerId, modelId: this.config.modelId } }
+                : {}),
+            ...(this.config.thinkingLevel !== undefined ? { thinkingLevel: this.config.thinkingLevel } : {}),
+            ...(this.config.instructions !== undefined ? { instructions: this.config.instructions } : {}),
+        };
+        return await harness.root(BACKGROUND_CONTEXT, { agent });
+    }
+    async findExistingRoot(harness) {
+        try {
+            return await harness.conversation(ROOT_CONVERSATION_ID, BACKGROUND_CONTEXT) ?? undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    assertGenerationConfigured() {
+        if (this.config.baseUrl === undefined) {
+            throw new Error('[pi-durable-not-configured] no baseUrl configured — generation is unavailable. '
+                + 'Set config.baseUrl (and apiKeyEnv) on the hy-sde-pi-durable row; passive writes and tasks still work.');
+        }
+    }
+    /**
+     * Submit user input to the root conversation. Exactly-once per `requestId`
+     * (scoped to the conversation); the run continues in the background.
+     */
+    async submitInput(input, options = {}) {
+        this.assertGenerationConfigured();
+        const root = await this.root();
+        const draft = {
+            type: 'input',
+            content: input,
+            ...(options.requestId !== undefined ? { requestId: options.requestId } : {}),
+            ...(options.whenBusy !== undefined ? { whenBusy: options.whenBusy } : {}),
+        };
+        const submission = await root.submit(draft, BACKGROUND_CONTEXT);
+        const record = await submission.status(BACKGROUND_CONTEXT);
+        return { submissionId: String(submission.id), record };
+    }
+    /**
+     * Admit a passive entry write to the root conversation — durable
+     * bookkeeping that never triggers a generation run.
+     */
+    async writeEntry(kind, data, requestId) {
+        const root = await this.root();
+        const draft = {
+            type: 'write',
+            entry: { kind, data },
+            ...(requestId !== undefined ? { requestId } : {}),
+        };
+        const submission = await root.submit(draft, BACKGROUND_CONTEXT);
+        const record = await submission.status(BACKGROUND_CONTEXT);
+        return { submissionId: String(submission.id), record };
+    }
+    /** Resolve one submission record by id (undefined when unknown). */
+    async submissionRecord(id) {
+        const harness = await this.harnessOf();
+        const submission = await harness.submission(Number(id), BACKGROUND_CONTEXT);
+        if (submission === undefined)
+            return undefined;
+        return await submission.status(BACKGROUND_CONTEXT);
+    }
+    /** Newest-first fork-aware page of the root conversation's history. */
+    async history(limit, cursor) {
+        const root = await this.root();
+        return await root.entries({}, limit, cursor, BACKGROUND_CONTEXT);
+    }
+    /** Newest-first page of any conversation's history (used for forks). */
+    async historyOf(conversationId, limit, cursor) {
+        const harness = await this.harnessOf();
+        const conversation = await harness.conversation(Number(conversationId), BACKGROUND_CONTEXT);
+        if (conversation === undefined) {
+            throw new Error(`[pi-durable-unknown-conversation] no conversation ${conversationId}`);
+        }
+        return await conversation.entries({}, limit, cursor, BACKGROUND_CONTEXT);
+    }
+    /** Fork the root conversation at an entry; history up to `entryId` is inherited. */
+    async forkFrom(entryId, options = {}) {
+        const root = await this.root();
+        const conversation = await root.fork(Number(entryId), {
+            ownership: { kind: 'ownerless' },
+            ...(options.instructions !== undefined ? { agent: { instructions: options.instructions } } : {}),
+        }, BACKGROUND_CONTEXT);
+        return { conversationId: String(conversation.id) };
+    }
+    /** Abort the root conversation's ordinary scope and resolve when idle. */
+    async abortRoot() {
+        const root = await this.root();
+        await root.abort(BACKGROUND_CONTEXT);
+    }
+    /** Point-in-time status of the engine. */
+    async status() {
+        const harness = await this.harnessOf();
+        const root = await this.root();
+        const inspection = await harness.inspect(BACKGROUND_CONTEXT);
+        return {
+            rootConversationId: String(root.id),
+            inspection,
+            generationConfigured: this.config.baseUrl !== undefined,
+        };
+    }
+    /** Seal admission, settle commits, close storage. Idempotent. */
+    async close() {
+        try {
+            await this.openPromise;
+        }
+        catch {
+            return; // init failed: nothing to close
+        }
+        const harness = this.harness;
+        this.harness = undefined;
+        this.rootPromise = undefined;
+        if (harness !== undefined) {
+            await harness.close(BACKGROUND_CONTEXT);
+        }
+    }
+}
+/** The engine's registry: the CodingTools toolset installed by default. */
+function createEngineRegistry() {
+    const registry = createRegistry();
+    registry.install(CodingTools);
+    return registry;
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Configuration resolution for the pi-durable engine plugin.
+ * @module
+ */
+/** Thinking levels accepted on the row (`AgentChange.thinkingLevel`). */
+export type PiDurableThinkingLevel = 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+/** Raw plugin configuration as accepted from the cordis row. */
+export interface PiDurablePluginConfig {
+    /** SQLite database path (default: `<DSH_HOME|~/.dsh>/storages/pi-agent.sqlite`). */
+    path?: string;
+    /** OpenAI-compatible endpoint base URL; unset = write-only mode (no generation). */
+    baseUrl?: string;
+    /** Environment variable carrying the relay API key (default `PI_DURABLE_API_KEY`). */
+    apiKeyEnv?: string;
+    /** Inline API key (development only; prefer `apiKeyEnv`). */
+    apiKey?: string;
+    /** Provider id registered into the pi-ai model registry (default `dsh-relay`). */
+    providerId?: string;
+    /** Provider display name (default `DSH Relay`). */
+    providerName?: string;
+    /** Model id sent to the relay (default `default`). */
+    modelId?: string;
+    /** Model display name (default: the model id). */
+    modelName?: string;
+    /** Wire API: `openai-completions` (default) or `openai-responses`. */
+    api?: 'openai-completions' | 'openai-responses';
+    /** Advertised context window (default 200000). */
+    contextWindow?: number;
+    /** Advertised max output tokens (default 8192). */
+    maxTokens?: number;
+    /** Working directory for the durable agent's coding tools (default: process cwd). */
+    cwd?: string;
+    /** Instructions applied when the root conversation is first created. */
+    instructions?: string;
+    /** Thinking level for the root agent (default unset → provider default). */
+    thinkingLevel?: PiDurableThinkingLevel;
+}
+/** Fully resolved engine configuration. */
+export interface ResolvedPiDurableConfig {
+    readonly path: string;
+    readonly baseUrl: string | undefined;
+    readonly apiKeyEnv: string;
+    readonly apiKey: string | undefined;
+    readonly providerId: string;
+    readonly providerName: string;
+    readonly modelId: string;
+    readonly modelName: string;
+    readonly api: 'openai-completions' | 'openai-responses';
+    readonly contextWindow: number;
+    readonly maxTokens: number;
+    readonly cwd: string;
+    readonly instructions: string | undefined;
+    readonly thinkingLevel: PiDurableThinkingLevel | undefined;
+}
+/** Default database path under the DSH home (env `DSH_HOME`, else `~/.dsh`). */
+export declare function defaultPiDurableDbPath(): string;
+/** Resolve row defaults into the immutable runtime config. */
+export declare function resolvePiDurableConfig(config: PiDurablePluginConfig): ResolvedPiDurableConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,yEAAyE;AACzE,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAA;AAEpG,gEAAgE;AAChE,MAAM,WAAW,qBAAqB;IACpC,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sEAAsE;IACtE,GAAG,CAAC,EAAE,oBAAoB,GAAG,kBAAkB,CAAA;IAC/C,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qFAAqF;IACrF,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,sBAAsB,CAAA;CACvC;AAED,2CAA2C;AAC3C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,GAAG,EAAE,oBAAoB,GAAG,kBAAkB,CAAA;IACvD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,aAAa,EAAE,sBAAsB,GAAG,SAAS,CAAA;CAC3D;AAED,gFAAgF;AAChF,wBAAgB,sBAAsB,IAAI,MAAM,CAG/C;AAQD,8DAA8D;AAC9D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,GAAG,uBAAuB,CAmB7F"}

package/dist/config.js

@@ -0,0 +1,38 @@
+/**
+ * Configuration resolution for the pi-durable engine plugin.
+ * @module
+ */
+import os from 'node:os';
+import path from 'node:path';
+/** Default database path under the DSH home (env `DSH_HOME`, else `~/.dsh`). */
+export function defaultPiDurableDbPath() {
+    const dshHome = process.env.DSH_HOME ?? path.join(os.homedir(), '.dsh');
+    return path.join(dshHome, 'storages', 'pi-agent.sqlite');
+}
+/** Trim a configured URL; empty/whitespace counts as unset. */
+function normalizeBaseUrl(baseUrl) {
+    const trimmed = baseUrl?.trim();
+    return trimmed === undefined || trimmed === '' ? undefined : trimmed;
+}
+/** Resolve row defaults into the immutable runtime config. */
+export function resolvePiDurableConfig(config) {
+    const api = config.api === 'openai-responses' ? 'openai-responses' : 'openai-completions';
+    const modelId = config.modelId ?? 'default';
+    return {
+        path: config.path ?? defaultPiDurableDbPath(),
+        baseUrl: normalizeBaseUrl(config.baseUrl),
+        apiKeyEnv: config.apiKeyEnv ?? 'PI_DURABLE_API_KEY',
+        apiKey: config.apiKey,
+        providerId: config.providerId ?? 'dsh-relay',
+        providerName: config.providerName ?? 'DSH Relay',
+        modelId,
+        modelName: config.modelName ?? modelId,
+        api,
+        contextWindow: config.contextWindow ?? 200_000,
+        maxTokens: config.maxTokens ?? 8_192,
+        cwd: config.cwd ?? process.cwd(),
+        instructions: config.instructions,
+        thinkingLevel: config.thinkingLevel,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAuD5B,gFAAgF;AAChF,MAAM,UAAU,sBAAsB;IACpC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAA;IACvE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAA;AAC1D,CAAC;AAED,+DAA+D;AAC/D,SAAS,gBAAgB,CAAC,OAA2B;IACnD,MAAM,OAAO,GAAG,OAAO,EAAE,IAAI,EAAE,CAAA;IAC/B,OAAO,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAA;AACtE,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,sBAAsB,CAAC,MAA6B;IAClE,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,KAAK,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,oBAAoB,CAAA;IACzF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,SAAS,CAAA;IAC3C,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,sBAAsB,EAAE;QAC7C,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC;QACzC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,oBAAoB;QACnD,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,WAAW;QAC5C,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,WAAW;QAChD,OAAO;QACP,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,OAAO;QACtC,GAAG;QACH,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,OAAO;QAC9C,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,KAAK;QACpC,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;QAChC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,aAAa,EAAE,MAAM,CAAC,aAAa;KACpC,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @hy-sde-org/dsh-pi-durable — the durable-agent engine plugin for DeepSeek
+ * Harness. Publishes the `piDurableAgent` service: a pi-durable Harness over
+ * a SQLite storage backend with an OpenAI-compatible relay provider, plus a
+ * narrow facade (submit / write / history / fork / abort / status) that the
+ * model-facing tools in @hy-sde-org/dsh-tool-pi-durable consume.
+ * @module @hy-sde-org/dsh-pi-durable
+ */
+export { SERVICE_PI_DURABLE, default as plugin } from './plugin.ts';
+export type { Config } from './plugin.ts';
+export { defaultPiDurableDbPath, resolvePiDurableConfig, type PiDurablePluginConfig, type PiDurableThinkingLevel, type ResolvedPiDurableConfig, } from './config.ts';
+export { createRelayProvider } from './provider.ts';
+export { PiDurableAgent, type PiDurableStatus, type RootSubmissionOutcome } from './agent.ts';
+export type { JsonValue } from '@earendil-works/chord';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAA;AACnE,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAC7F,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * @hy-sde-org/dsh-pi-durable — the durable-agent engine plugin for DeepSeek
+ * Harness. Publishes the `piDurableAgent` service: a pi-durable Harness over
+ * a SQLite storage backend with an OpenAI-compatible relay provider, plus a
+ * narrow facade (submit / write / history / fork / abort / status) that the
+ * model-facing tools in @hy-sde-org/dsh-tool-pi-durable consume.
+ * @module @hy-sde-org/dsh-pi-durable
+ */
+export { SERVICE_PI_DURABLE, default as plugin } from "./plugin.js";
+export { defaultPiDurableDbPath, resolvePiDurableConfig, } from "./config.js";
+export { createRelayProvider } from "./provider.js";
+export { PiDurableAgent } from "./agent.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;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAA;AAEnE,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GAIvB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,cAAc,EAAoD,MAAM,YAAY,CAAA"}

package/dist/plugin.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Cordis host-plane plugin publishing the `piDurableAgent` service: the
+ * durable-agent engine over @earendil-works/pi-durable. The service is
+ * provided synchronously (a facade whose first use awaits the eager open),
+ * so agent presets resolve it at apply time without racing the SQLite init.
+ * @module
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import { type PiDurablePluginConfig } from './config.ts';
+/** Name of the published service (consumed by @hy-sde-org/dsh-tool-pi-durable). */
+export declare const SERVICE_PI_DURABLE = "piDurableAgent";
+/** Cordis plugin name. */
+export declare const name = "pi-durable";
+/** No host services injected: the engine owns its storage medium outright. */
+export declare const inject: readonly string[];
+/** Plugin configuration (see the row comments in cordis.patch.yml). */
+export type Config = PiDurablePluginConfig;
+/** Plugin config schema; every field is optional with engine defaults. */
+export declare const Config: z<Config>;
+/**
+ * Provide the engine facade and tie its teardown to the plugin fiber, so an
+ * unload (HMR included) closes the harness and storage with it.
+ * @param ctx - host-plane plugin context.
+ * @param config - validated row configuration.
+ */
+export declare function apply(ctx: Context, config: Config): void;
+declare const _default: {
+    name: string;
+    inject: readonly string[];
+    apply: typeof apply;
+};
+export default _default;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC,OAAO,EAA0B,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAEhF,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,mBAAmB,CAAA;AAElD,0BAA0B;AAC1B,eAAO,MAAM,IAAI,eAAe,CAAA;AAEhC,8EAA8E;AAC9E,eAAO,MAAM,MAAM,EAAE,SAAS,MAAM,EAAO,CAAA;AAE3C,uEAAuE;AACvE,MAAM,MAAM,MAAM,GAAG,qBAAqB,CAAA;AAE1C,0EAA0E;AAC1E,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAuB3B,CAAA;AAEF;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAOxD;;;;;;AAED,wBAAsC"}

package/dist/plugin.js

@@ -0,0 +1,57 @@
+/**
+ * Cordis host-plane plugin publishing the `piDurableAgent` service: the
+ * durable-agent engine over @earendil-works/pi-durable. The service is
+ * provided synchronously (a facade whose first use awaits the eager open),
+ * so agent presets resolve it at apply time without racing the SQLite init.
+ * @module
+ */
+import z from '@deepseek-ai/schemastery';
+import { PiDurableAgent } from "./agent.js";
+import { resolvePiDurableConfig } from "./config.js";
+/** Name of the published service (consumed by @hy-sde-org/dsh-tool-pi-durable). */
+export const SERVICE_PI_DURABLE = 'piDurableAgent';
+/** Cordis plugin name. */
+export const name = 'pi-durable';
+/** No host services injected: the engine owns its storage medium outright. */
+export const inject = [];
+/** Plugin config schema; every field is optional with engine defaults. */
+export const Config = z.object({
+    path: z.string(),
+    baseUrl: z.string(),
+    apiKeyEnv: z.string().default('PI_DURABLE_API_KEY'),
+    apiKey: z.string(),
+    providerId: z.string().default('dsh-relay'),
+    providerName: z.string(),
+    modelId: z.string().default('default'),
+    modelName: z.string(),
+    api: z.union(['openai-completions', 'openai-responses']),
+    contextWindow: z.number().step(1).min(1),
+    maxTokens: z.number().step(1).min(1),
+    cwd: z.string(),
+    instructions: z.string(),
+    thinkingLevel: z.union([
+        'off',
+        'minimal',
+        'low',
+        'medium',
+        'high',
+        'xhigh',
+        'max',
+    ]),
+});
+/**
+ * Provide the engine facade and tie its teardown to the plugin fiber, so an
+ * unload (HMR included) closes the harness and storage with it.
+ * @param ctx - host-plane plugin context.
+ * @param config - validated row configuration.
+ */
+export function apply(ctx, config) {
+    const resolved = resolvePiDurableConfig(config);
+    const agent = new PiDurableAgent(resolved);
+    ctx.provide(SERVICE_PI_DURABLE, agent);
+    ctx.effect(() => async () => {
+        await agent.close();
+    }, 'pi-durable.close()');
+}
+export default { name, inject, apply };
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EAAE,sBAAsB,EAA8B,MAAM,aAAa,CAAA;AAEhF,mFAAmF;AACnF,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAA;AAElD,0BAA0B;AAC1B,MAAM,CAAC,MAAM,IAAI,GAAG,YAAY,CAAA;AAEhC,8EAA8E;AAC9E,MAAM,CAAC,MAAM,MAAM,GAAsB,EAAE,CAAA;AAK3C,0EAA0E;AAC1E,MAAM,CAAC,MAAM,MAAM,GAAc,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,oBAAoB,CAAC;IACnD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC;IAC3C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IACtC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,oBAAoB,EAAE,kBAAkB,CAAU,CAAC;IACjE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC;QACrB,KAAK;QACL,SAAS;QACT,KAAK;QACL,QAAQ;QACR,MAAM;QACN,OAAO;QACP,KAAK;KACG,CAAC;CACZ,CAAC,CAAA;AAEF;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,GAAY,EAAE,MAAc;IAChD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAA;IAC/C,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,QAAQ,CAAC,CAAA;IAC1C,GAAG,CAAC,OAAO,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAA;IACtC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE;QAC1B,MAAM,KAAK,CAAC,KAAK,EAAE,CAAA;IACrB,CAAC,EAAE,oBAAoB,CAAC,CAAA;AAC1B,CAAC;AAED,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA"}

package/dist/provider.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The OpenAI-compatible relay provider registered into the pi-ai model
+ * registry. Auth resolves lazily at request time from the configured env
+ * variable (or inline key), so rotating the secret needs no remount.
+ * @module
+ */
+import { type Api, type Provider } from '@earendil-works/pi-ai';
+import type { ResolvedPiDurableConfig } from './config.ts';
+/** Build the relay provider from resolved config (only called with a `baseUrl`). */
+export declare function createRelayProvider(config: ResolvedPiDurableConfig): Provider<Api>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,GAAG,EAGR,KAAK,QAAQ,EACd,MAAM,uBAAuB,CAAA;AAG9B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAiB1D,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,uBAAuB,GAAG,QAAQ,CAAC,GAAG,CAAC,CA6BlF"}

package/dist/provider.js

@@ -0,0 +1,53 @@
+/**
+ * The OpenAI-compatible relay provider registered into the pi-ai model
+ * registry. Auth resolves lazily at request time from the configured env
+ * variable (or inline key), so rotating the secret needs no remount.
+ * @module
+ */
+import { createProvider, } from '@earendil-works/pi-ai';
+import { openAICompletionsApi } from '@earendil-works/pi-ai/api/openai-completions.lazy';
+import { openAIResponsesApi } from '@earendil-works/pi-ai/api/openai-responses.lazy';
+/**
+ * An {@link ApiKeyAuth} that resolves from config/env at request time. No
+ * credential store is consulted: the row's env var is the single source.
+ */
+function configApiKeyAuth(name, resolve) {
+    return {
+        name,
+        async resolve() {
+            const key = resolve();
+            if (key === undefined || key === '')
+                return undefined;
+            return { auth: { apiKey: key }, source: name };
+        },
+    };
+}
+/** Build the relay provider from resolved config (only called with a `baseUrl`). */
+export function createRelayProvider(config) {
+    if (config.baseUrl === undefined) {
+        throw new Error('[pi-durable-not-configured] createRelayProvider requires a baseUrl');
+    }
+    const model = {
+        id: config.modelId,
+        name: config.modelName,
+        api: config.api,
+        provider: config.providerId,
+        baseUrl: config.baseUrl,
+        input: ['text'],
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+        reasoning: true,
+        contextWindow: config.contextWindow,
+        maxTokens: config.maxTokens,
+    };
+    return createProvider({
+        id: config.providerId,
+        name: config.providerName,
+        baseUrl: config.baseUrl,
+        auth: {
+            apiKey: configApiKeyAuth(`${config.providerName} API key`, () => config.apiKey ?? process.env[config.apiKeyEnv]),
+        },
+        models: [model],
+        api: config.api === 'openai-responses' ? openAIResponsesApi() : openAICompletionsApi(),
+    });
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,GAKf,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAA;AACxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAA;AAGpF;;;GAGG;AACH,SAAS,gBAAgB,CAAC,IAAY,EAAE,OAAiC;IACvE,OAAO;QACL,IAAI;QACJ,KAAK,CAAC,OAAO;YACX,MAAM,GAAG,GAAG,OAAO,EAAE,CAAA;YACrB,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;gBAAE,OAAO,SAAS,CAAA;YACrD,OAAO,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;QAChD,CAAC;KACF,CAAA;AACH,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,mBAAmB,CAAC,MAA+B;IACjE,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAA;IACvF,CAAC;IACD,MAAM,KAAK,GAAe;QACxB,EAAE,EAAE,MAAM,CAAC,OAAO;QAClB,IAAI,EAAE,MAAM,CAAC,SAAS;QACtB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,QAAQ,EAAE,MAAM,CAAC,UAAU;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE;QAC1D,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAA;IACD,OAAO,cAAc,CAAM;QACzB,EAAE,EAAE,MAAM,CAAC,UAAU;QACrB,IAAI,EAAE,MAAM,CAAC,YAAY;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,IAAI,EAAE;YACJ,MAAM,EAAE,gBAAgB,CACtB,GAAG,MAAM,CAAC,YAAY,UAAU,EAChC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CACrD;SACF;QACD,MAAM,EAAE,CAAC,KAAK,CAAC;QACf,GAAG,EAAE,MAAM,CAAC,GAAG,KAAK,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,oBAAoB,EAAE;KACvF,CAAC,CAAA;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@hy-sde-org/dsh-pi-durable",
+  "version": "0.2.0-rc.2",
+  "description": "The durable-agent engine for DeepSeek Harness: a host-plane cordis service mounting @earendil-works/pi-durable (conversations, exactly-once submissions, fork-at-entry, tasks) over a SQLite storage backend with an OpenAI-compatible relay provider.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hy-sde/dsh-plugins.git",
+    "directory": "dsh-pi-durable/packages/pi-durable"
+  },
+  "license": "MIT",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "dependencies": {
+    "@earendil-works/chord": "^1.0.0",
+    "@earendil-works/pi-ai": "^1.0.0",
+    "@earendil-works/pi-durable": "^1.0.0",
+    "@deepseek-ai/schemastery": "~3.18.4"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "~4.0.4"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "~4.0.4",
+    "@deepseek-ai/schemastery": "~3.18.4",
+    "@types/node": "^24.13.3",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.7"
+  },
+  "keywords": [
+    "deepseek",
+    "agent",
+    "harness",
+    "dsh-plugin",
+    "pi-durable",
+    "durable",
+    "durable-agent"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc -p tsconfig.build.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}