@dotcraft/sdk 0.5.9

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,wBAAwB,EACxB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,QAAQ,EACR,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,2BAA2B,EAC3B,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,QAAQ,GACT,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+/** Curated high-level DotCraft SDK API. */
+export { DotCraft, DotCraftThread } from "./dotcraft.js";
+export { ApprovalTimeoutError, DotCraftError, InitializationError, ProtocolViolationError, RunDisconnectedError, ThreadNotActiveError, ThreadNotFoundError, TurnCancelledError, TurnFailedError, TurnInProgressError, } from "./errors.js";
+export { DECISION_ACCEPT, DECISION_ACCEPT_ALWAYS, DECISION_ACCEPT_FOR_SESSION, DECISION_CANCEL, DECISION_DECLINE, commandRefPart, fileRefPart, imageDataUrlPart, localImagePart, skillRefPart, textPart, } from "./models.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,2CAA2C;AAE3C,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AA4BzD,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,2BAA2B,EAC3B,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,QAAQ,GACT,MAAM,aAAa,CAAC"}

package/dist/meta.d.ts

@@ -0,0 +1,2 @@
+export { APPSERVER_PROTOCOL_VERSION, CONTRACT_SHA256, CONTRACT_VERSION, SDK_VERSION, } from "./generated/appserver/protocol-info.generated.js";
+//# sourceMappingURL=meta.d.ts.map

package/dist/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../src/meta.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,gBAAgB,EAChB,WAAW,GACZ,MAAM,kDAAkD,CAAC"}

package/dist/meta.js

@@ -0,0 +1,2 @@
+export { APPSERVER_PROTOCOL_VERSION, CONTRACT_SHA256, CONTRACT_VERSION, SDK_VERSION, } from "./generated/appserver/protocol-info.generated.js";
+//# sourceMappingURL=meta.js.map

package/dist/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../src/meta.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,gBAAgB,EAChB,WAAW,GACZ,MAAM,kDAAkD,CAAC"}

package/dist/models.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Wire DTO models for the DotCraft AppServer Wire Protocol.
+ */
+import type { InputPart } from "./generated/appserver/index.js";
+/** Parsed JSON-RPC 2.0 message. */
+export declare class JsonRpcMessage {
+    method?: string | null;
+    id?: number | string | null;
+    params?: Record<string, unknown> | null;
+    result?: any;
+    error?: {
+        code?: number;
+        message?: string;
+        data?: unknown;
+    } | null;
+    constructor(init?: Partial<JsonRpcMessage>);
+    get isRequest(): boolean;
+    get isNotification(): boolean;
+    get isResponse(): boolean;
+    static fromDict(data: Record<string, unknown>): JsonRpcMessage;
+    toDict(): Record<string, unknown>;
+}
+export declare function textPart(text: string): InputPart;
+export declare function imageDataUrlPart(dataUrl: string): InputPart;
+export declare function localImagePart(path: string): InputPart;
+export declare function skillRefPart(name: string): InputPart;
+export declare function commandRefPart(rawText: string): InputPart;
+export declare function fileRefPart(path: string, displayPath?: string): InputPart;
+export declare const DECISION_ACCEPT = "accept";
+export declare const DECISION_ACCEPT_FOR_SESSION = "acceptForSession";
+export declare const DECISION_ACCEPT_ALWAYS = "acceptAlways";
+export declare const DECISION_DECLINE = "decline";
+export declare const DECISION_CANCEL = "cancel";
+export declare const ERR_NOT_INITIALIZED = -32002;
+export declare const ERR_ALREADY_INITIALIZED = -32003;
+export declare const ERR_THREAD_NOT_FOUND = -32010;
+export declare const ERR_THREAD_NOT_ACTIVE = -32011;
+export declare const ERR_TURN_IN_PROGRESS = -32012;
+export declare const ERR_TURN_NOT_FOUND = -32013;
+export declare const ERR_TURN_NOT_RUNNING = -32014;
+export declare const ERR_APPROVAL_TIMEOUT = -32020;
+export declare const ERR_CHANNEL_REJECTED = -32030;
+export declare const ERR_CRON_NOT_FOUND = -32031;
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAEhE,mCAAmC;AACnC,qBAAa,cAAc;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAExC,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;gBAEvD,IAAI,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAI1C,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc;IAU9D,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CASlC;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAEhD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAE3D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAEtD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAEpD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAYzD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAMzE;AAED,eAAO,MAAM,eAAe,WAAW,CAAC;AACxC,eAAO,MAAM,2BAA2B,qBAAqB,CAAC;AAC9D,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AACrD,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAC1C,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAC1C,eAAO,MAAM,uBAAuB,SAAS,CAAC;AAC9C,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAC3C,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAC5C,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAC3C,eAAO,MAAM,kBAAkB,SAAS,CAAC;AACzC,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAC3C,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAC3C,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAC3C,eAAO,MAAM,kBAAkB,SAAS,CAAC"}

package/dist/models.js

@@ -0,0 +1,96 @@
+/**
+ * Wire DTO models for the DotCraft AppServer Wire Protocol.
+ */
+/** Parsed JSON-RPC 2.0 message. */
+export class JsonRpcMessage {
+    method;
+    id;
+    params;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    result;
+    error;
+    constructor(init) {
+        if (init)
+            Object.assign(this, init);
+    }
+    get isRequest() {
+        return this.id != null && this.method != null;
+    }
+    get isNotification() {
+        return this.id == null && this.method != null;
+    }
+    get isResponse() {
+        return this.id != null && this.method == null;
+    }
+    static fromDict(data) {
+        return new JsonRpcMessage({
+            method: data.method,
+            id: data.id,
+            params: data.params ?? null,
+            result: data.result,
+            error: data.error,
+        });
+    }
+    toDict() {
+        const out = { jsonrpc: "2.0" };
+        if (this.id != null)
+            out.id = this.id;
+        if (this.method != null && this.method !== undefined)
+            out.method = this.method;
+        if (this.params != null)
+            out.params = this.params;
+        if (this.result !== undefined)
+            out.result = this.result;
+        if (this.error != null)
+            out.error = this.error;
+        return out;
+    }
+}
+export function textPart(text) {
+    return { type: "text", text };
+}
+export function imageDataUrlPart(dataUrl) {
+    return { type: "image", url: dataUrl };
+}
+export function localImagePart(path) {
+    return { type: "localImage", path };
+}
+export function skillRefPart(name) {
+    return { type: "skillRef", name };
+}
+export function commandRefPart(rawText) {
+    const normalized = rawText.trim();
+    const firstSpace = normalized.search(/\s/);
+    const token = firstSpace >= 0 ? normalized.slice(0, firstSpace) : normalized;
+    const name = token.replace(/^\//, "");
+    const argsText = firstSpace >= 0 ? normalized.slice(firstSpace + 1).trim() : "";
+    return {
+        type: "commandRef",
+        name,
+        rawText: normalized,
+        ...(argsText ? { argsText } : {}),
+    };
+}
+export function fileRefPart(path, displayPath) {
+    return {
+        type: "fileRef",
+        path,
+        ...(displayPath ? { displayPath } : {}),
+    };
+}
+export const DECISION_ACCEPT = "accept";
+export const DECISION_ACCEPT_FOR_SESSION = "acceptForSession";
+export const DECISION_ACCEPT_ALWAYS = "acceptAlways";
+export const DECISION_DECLINE = "decline";
+export const DECISION_CANCEL = "cancel";
+export const ERR_NOT_INITIALIZED = -32002;
+export const ERR_ALREADY_INITIALIZED = -32003;
+export const ERR_THREAD_NOT_FOUND = -32010;
+export const ERR_THREAD_NOT_ACTIVE = -32011;
+export const ERR_TURN_IN_PROGRESS = -32012;
+export const ERR_TURN_NOT_FOUND = -32013;
+export const ERR_TURN_NOT_RUNNING = -32014;
+export const ERR_APPROVAL_TIMEOUT = -32020;
+export const ERR_CHANNEL_REJECTED = -32030;
+export const ERR_CRON_NOT_FOUND = -32031;
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

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

package/dist/protocolBaseline.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=protocolBaseline.test.d.ts.map

package/dist/protocolBaseline.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocolBaseline.test.d.ts","sourceRoot":"","sources":["../src/protocolBaseline.test.ts"],"names":[],"mappings":""}

package/dist/protocolBaseline.test.js

@@ -0,0 +1,77 @@
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import test from "node:test";
+import { DotCraftWireClient } from "./client.js";
+import { TransportClosed } from "./transport.js";
+class FixtureTransport {
+    queued = [];
+    readers = [];
+    closed = false;
+    push(message) {
+        const reader = this.readers.shift();
+        if (reader)
+            reader(message);
+        else
+            this.queued.push(message);
+    }
+    async readMessage() {
+        if (this.closed)
+            throw new TransportClosed();
+        const message = this.queued.shift();
+        if (message)
+            return message;
+        return await new Promise((resolve) => this.readers.push(resolve));
+    }
+    async writeMessage(_message) { }
+    async close() {
+        this.closed = true;
+    }
+}
+const fixtures = JSON.parse(readFileSync(new URL("../../../specs/protocols/fixtures/appserver-v1/messages.json", import.meta.url), "utf8"));
+function fixtureCase(name) {
+    const value = fixtures.cases.find((item) => item.name === name);
+    assert.ok(value, `missing fixture case: ${name}`);
+    return value;
+}
+test("shared AppServer fixtures expose portable lifecycle and callback cases", () => {
+    assert.equal(fixtures.version, 1);
+    for (const name of [
+        "initialize",
+        "thread-start-response-before-notification",
+        "turn-start-and-complete",
+        "approval-callback",
+        "user-input-callback",
+        "dynamic-tool-callback",
+        "structured-error",
+        "opaque-mcp-result",
+        "core-domain-catalog",
+        "mcp-elicitation-callback",
+        "app-binding",
+        "automation",
+        "teams",
+        "acp-callbacks",
+        "node-repl-callback",
+        "external-channel",
+    ]) {
+        assert.ok(fixtureCase(name).messages.length > 0);
+    }
+});
+test("wire client preserves the shared unknown-notification fixture", async () => {
+    const transport = new FixtureTransport();
+    const client = new DotCraftWireClient(transport);
+    await client.start();
+    const received = new Promise((resolve) => {
+        client.onRaw("fixture/unknownNotification", resolve);
+    });
+    transport.push(fixtureCase("unknown-notification").messages[0]);
+    const params = await received;
+    assert.equal(params.preserveMe, true);
+    assert.deepEqual(params.future, { nested: [1, "two", null] });
+    await client.stop();
+});
+test("raw TypeScript consumers retain opaque MCP fields", () => {
+    const result = fixtureCase("opaque-mcp-result").messages[1].result;
+    assert.deepEqual(result.futureResultField, { kept: true });
+    assert.deepEqual(result.structuredContent, { count: 1, futureShape: ["kept"] });
+});
+//# sourceMappingURL=protocolBaseline.test.js.map

package/dist/protocolBaseline.test.js.map

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

package/dist/publicApi.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=publicApi.test.d.ts.map

package/dist/publicApi.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publicApi.test.d.ts","sourceRoot":"","sources":["../src/publicApi.test.ts"],"names":[],"mappings":""}

package/dist/publicApi.test.js

@@ -0,0 +1,29 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+test("documented SDK entry points are importable and curated", async () => {
+    const [root, contracts, wire, hub, appBinding, dynamicTools, testing, meta] = await Promise.all([
+        import("@dotcraft/sdk"),
+        import("@dotcraft/sdk/contracts"),
+        import("@dotcraft/sdk/wire"),
+        import("@dotcraft/sdk/hub"),
+        import("@dotcraft/sdk/app-binding"),
+        import("@dotcraft/sdk/dynamic-tools"),
+        import("@dotcraft/sdk/testing"),
+        import("@dotcraft/sdk/meta"),
+    ]);
+    assert.equal(typeof root.DotCraft, "function");
+    assert.equal("InternalAppServerClient" in root, false);
+    assert.equal("DotCraftWireClient" in root, false);
+    assert.equal(typeof contracts.CONTRACT_VERSION, "string");
+    assert.equal("SessionThread" in wire, false);
+    assert.equal("mergeReplyTextFromDeltaAndSnapshot" in wire, false);
+    assert.equal(typeof wire.DotCraftWireClient, "function");
+    assert.ok(hub && appBinding && dynamicTools && testing);
+    assert.equal(typeof meta.SDK_VERSION, "string");
+});
+test("removed SDK subpaths are not exported", async () => {
+    for (const specifier of ["@dotcraft/sdk/appserver", "@dotcraft/sdk/channel"]) {
+        await assert.rejects(import(specifier), (error) => error instanceof Error && "code" in error && error.code === "ERR_PACKAGE_PATH_NOT_EXPORTED");
+    }
+});
+//# sourceMappingURL=publicApi.test.js.map

package/dist/publicApi.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publicApi.test.js","sourceRoot":"","sources":["../src/publicApi.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,IAAI,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;IACxE,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC9F,MAAM,CAAC,eAAe,CAAC;QACvB,MAAM,CAAC,yBAAyB,CAAC;QACjC,MAAM,CAAC,oBAAoB,CAAC;QAC5B,MAAM,CAAC,mBAAmB,CAAC;QAC3B,MAAM,CAAC,2BAA2B,CAAC;QACnC,MAAM,CAAC,6BAA6B,CAAC;QACrC,MAAM,CAAC,uBAAuB,CAAC;QAC/B,MAAM,CAAC,oBAAoB,CAAC;KAC7B,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC/C,MAAM,CAAC,KAAK,CAAC,yBAAyB,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC;IACvD,MAAM,CAAC,KAAK,CAAC,oBAAoB,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;IAC1D,MAAM,CAAC,KAAK,CAAC,eAAe,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,CAAC,oCAAoC,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC;IAClE,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;IACzD,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,UAAU,IAAI,YAAY,IAAI,OAAO,CAAC,CAAC;IACxD,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AAClD,CAAC,CAAC,CAAC;AACH,IAAI,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;IACvD,KAAK,MAAM,SAAS,IAAI,CAAC,yBAAyB,EAAE,uBAAuB,CAAC,EAAE,CAAC;QAC7E,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,KAAc,EAAE,EAAE,CACzD,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,+BAA+B,CAAC,CAAC;IACjG,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/test-contract-fixtures.d.ts

@@ -0,0 +1,6 @@
+import type { ServerCapabilities, ServerInfo, SessionThread, SessionTurn } from "./generated/appserver/index.js";
+export declare function makeThread(id: string, status: string, workspacePath?: string, userId?: string, originChannel?: string): SessionThread;
+export declare function makeTurn(id: string, threadId: string, status: string): SessionTurn;
+export declare function makeServerInfo(name: string, version: string, protocolVersion: string): ServerInfo;
+export declare function makeServerCapabilities(): ServerCapabilities;
+//# sourceMappingURL=test-contract-fixtures.d.ts.map

package/dist/test-contract-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-contract-fixtures.d.ts","sourceRoot":"","sources":["../src/test-contract-fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,WAAW,EACZ,MAAM,gCAAgC,CAAC;AAExC,wBAAgB,UAAU,CACxB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,aAAa,SAAK,EAClB,MAAM,SAAK,EACX,aAAa,SAAQ,GACpB,aAAa,CAsBf;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAElF;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU,CAEjG;AAED,wBAAgB,sBAAsB,IAAI,kBAAkB,CAE3D"}

package/dist/test-contract-fixtures.js

@@ -0,0 +1,33 @@
+export function makeThread(id, status, workspacePath = "", userId = "", originChannel = "sdk") {
+    const now = "2026-01-01T00:00:00.000Z";
+    return {
+        id,
+        status,
+        workspacePath,
+        effectiveWorkspacePath: workspacePath,
+        cwd: workspacePath,
+        userId,
+        originChannel,
+        createdAt: now,
+        lastActiveAt: now,
+        ephemeral: false,
+        historyMode: "server",
+        metadata: {},
+        queuedInputs: [],
+        runtime: {},
+        runtimeWorkspaceRoots: [],
+        sessionId: id,
+        source: { kind: "test" },
+        worktree: null,
+    };
+}
+export function makeTurn(id, threadId, status) {
+    return { id, threadId, status, startedAt: "2026-01-01T00:00:00.000Z" };
+}
+export function makeServerInfo(name, version, protocolVersion) {
+    return { name, version, protocolVersion };
+}
+export function makeServerCapabilities() {
+    return { protocolVersion: "1", version: "1", threadManagement: true, threadSubscriptions: true };
+}
+//# sourceMappingURL=test-contract-fixtures.js.map

package/dist/test-contract-fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-contract-fixtures.js","sourceRoot":"","sources":["../src/test-contract-fixtures.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,UAAU,CACxB,EAAU,EACV,MAAc,EACd,aAAa,GAAG,EAAE,EAClB,MAAM,GAAG,EAAE,EACX,aAAa,GAAG,KAAK;IAErB,MAAM,GAAG,GAAG,0BAA0B,CAAC;IACvC,OAAO;QACL,EAAE;QACF,MAAM;QACN,aAAa;QACb,sBAAsB,EAAE,aAAa;QACrC,GAAG,EAAE,aAAa;QAClB,MAAM;QACN,aAAa;QACb,SAAS,EAAE,GAAG;QACd,YAAY,EAAE,GAAG;QACjB,SAAS,EAAE,KAAK;QAChB,WAAW,EAAE,QAAQ;QACrB,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,EAAE;QAChB,OAAO,EAAE,EAAE;QACX,qBAAqB,EAAE,EAAE;QACzB,SAAS,EAAE,EAAE;QACb,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;QACxB,QAAQ,EAAE,IAAI;KACE,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,EAAU,EAAE,QAAgB,EAAE,MAAc;IACnE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,0BAA0B,EAAE,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAe,EAAE,eAAuB;IACnF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC;AACnG,CAAC"}

package/dist/testing.d.ts

@@ -0,0 +1,3 @@
+/** SDK transport and protocol test surface. */
+export { JsonRpcMessage } from "./models.js";
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/testing.js

@@ -0,0 +1,3 @@
+/** SDK transport and protocol test surface. */
+export { JsonRpcMessage } from "./models.js";
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/transport.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Transport layer: StdioTransport and WebSocketTransport.
+ */
+export declare class TransportError extends Error {
+    constructor(message: string);
+}
+export declare class TransportClosed extends TransportError {
+    constructor(message?: string);
+}
+/** Abstract transport that reads/writes JSON-RPC messages. */
+export interface Transport {
+    readMessage(): Promise<Record<string, unknown>>;
+    writeMessage(msg: Record<string, unknown>): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * Newline-delimited JSON (JSONL) on stdin/stdout.
+ * Used when DotCraft spawns the adapter as a subprocess.
+ */
+export declare class StdioTransport implements Transport {
+    private closed;
+    private readonly rl;
+    private lineIter;
+    constructor();
+    readMessage(): Promise<Record<string, unknown>>;
+    writeMessage(msg: Record<string, unknown>): Promise<void>;
+    close(): Promise<void>;
+}
+export interface WebSocketTransportOptions {
+    url: string;
+    token?: string | null;
+}
+/**
+ * One JSON-RPC message per WebSocket text frame.
+ */
+export declare class WebSocketTransport implements Transport {
+    private readonly baseUrl;
+    private readonly token;
+    private ws;
+    private closed;
+    private receivedFrames;
+    private waitingReaders;
+    private terminalError;
+    constructor(opts: WebSocketTransportOptions);
+    private get urlWithToken();
+    connect(): Promise<void>;
+    readMessage(): Promise<Record<string, unknown>>;
+    writeMessage(msg: Record<string, unknown>): Promise<void>;
+    close(): Promise<void>;
+    private attachSocketHandlers;
+    private rejectWaitingReaders;
+    private rawDataToUtf8;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,eAAgB,SAAQ,cAAc;gBACrC,OAAO,SAAqB;CAIzC;AAED,8DAA8D;AAC9D,MAAM,WAAW,SAAS;IACxB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChD,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,cAAe,YAAW,SAAS;IAC9C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAqC;IACxD,OAAO,CAAC,QAAQ,CAAsC;;IAMhD,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAe/C,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,kBAAmB,YAAW,SAAS;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4B;IAClD,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,cAAc,CAGd;IACR,OAAO,CAAC,aAAa,CAAiB;gBAE1B,IAAI,EAAE,yBAAyB;IAK3C,OAAO,KAAK,YAAY,GAYvB;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmCxB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAe/C,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IASzD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B,OAAO,CAAC,oBAAoB;IA4B5B,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,aAAa;CAQtB"}