@dotcraft/sdk 0.5.9

package/dist/generated/appserver/server-requests.generated.d.ts

@@ -0,0 +1,73 @@
+import type * as Models from "./models.generated.js";
+export interface ServerRequestMethods {
+    "ext/acp/fs/readTextFile": {
+        params: Models.AcpFsReadTextFileParams;
+        result: Models.AcpFsReadTextFileResult;
+    };
+    "ext/acp/fs/writeTextFile": {
+        params: Models.AcpFsWriteTextFileParams;
+        result: Models.AcpFsWriteTextFileResult;
+    };
+    "ext/acp/terminal/create": {
+        params: Models.AcpTerminalCreateParams;
+        result: Models.AcpTerminalCreateResult;
+    };
+    "ext/acp/terminal/getOutput": {
+        params: Models.AcpTerminalGetOutputParams;
+        result: Models.AcpTerminalOutputResult;
+    };
+    "ext/acp/terminal/kill": {
+        params: Models.AcpTerminalKillParams;
+        result: Models.RpcEmpty;
+    };
+    "ext/acp/terminal/release": {
+        params: Models.AcpTerminalReleaseParams;
+        result: Models.RpcEmpty;
+    };
+    "ext/acp/terminal/waitForExit": {
+        params: Models.AcpTerminalWaitForExitParams;
+        result: Models.AcpTerminalOutputResult;
+    };
+    "ext/channel/heartbeat": {
+        params: Models.RpcEmpty;
+        result: Models.RpcEmpty;
+    };
+    "ext/channel/send": {
+        params: Models.ExtChannelSendParams;
+        result: Models.ExtChannelSendResult;
+    };
+    "ext/channel/toolCall": {
+        params: Models.ExtChannelToolCallParams;
+        result: Models.ExtChannelToolCallResult;
+    };
+    "ext/nodeRepl/cancel": {
+        params: Models.NodeReplCancelParams;
+        result: Models.RpcEmpty;
+    };
+    "ext/nodeRepl/evaluate": {
+        params: Models.NodeReplEvaluateParams;
+        result: Models.NodeReplEvaluateResult;
+    };
+    "item/approval/request": {
+        params: Models.ApprovalRequestParams;
+        result: Models.ApprovalResponseResult;
+    };
+    "item/resource/read": {
+        params: Models.UiResourceReadParams;
+        result: Models.UiResourceReadResult;
+    };
+    "item/tool/call": {
+        params: Models.DynamicToolCallParams;
+        result: Models.DynamicToolCallResult;
+    };
+    "item/tool/requestUserInput": {
+        params: Models.UserInputRequestParams;
+        result: Models.UserInputResponseResult;
+    };
+    "mcpServer/elicitation/request": {
+        params: Models.McpServerElicitationRequestParams;
+        result: Models.McpServerElicitationResponse;
+    };
+}
+export type ServerRequestMethod = keyof ServerRequestMethods;
+//# sourceMappingURL=server-requests.generated.d.ts.map

package/dist/generated/appserver/server-requests.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-requests.generated.d.ts","sourceRoot":"","sources":["../../../src/generated/appserver/server-requests.generated.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,MAAM,uBAAuB,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACnC,yBAAyB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,uBAAuB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,uBAAuB,CAAA;KAAE,CAAC;IAC9G,0BAA0B,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,wBAAwB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,wBAAwB,CAAA;KAAE,CAAC;IACjH,yBAAyB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,uBAAuB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,uBAAuB,CAAA;KAAE,CAAC;IAC9G,4BAA4B,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,0BAA0B,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,uBAAuB,CAAA;KAAE,CAAC;IACpH,uBAAuB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,qBAAqB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAA;KAAE,CAAC;IAC3F,0BAA0B,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,wBAAwB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAA;KAAE,CAAC;IACjG,8BAA8B,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,4BAA4B,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,uBAAuB,CAAA;KAAE,CAAC;IACxH,uBAAuB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAA;KAAE,CAAC;IAC9E,kBAAkB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,oBAAoB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,CAAA;KAAE,CAAC;IACjG,sBAAsB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,wBAAwB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,wBAAwB,CAAA;KAAE,CAAC;IAC7G,qBAAqB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,oBAAoB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAA;KAAE,CAAC;IACxF,uBAAuB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,sBAAsB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,sBAAsB,CAAA;KAAE,CAAC;IAC1G,uBAAuB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,qBAAqB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,sBAAsB,CAAA;KAAE,CAAC;IACzG,oBAAoB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,oBAAoB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,CAAA;KAAE,CAAC;IACnG,gBAAgB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,qBAAqB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,qBAAqB,CAAA;KAAE,CAAC;IACjG,4BAA4B,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,sBAAsB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,uBAAuB,CAAA;KAAE,CAAC;IAChH,+BAA+B,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,iCAAiC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,4BAA4B,CAAA;KAAE,CAAC;CACpI;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,oBAAoB,CAAC"}

package/dist/generated/appserver/server-requests.generated.js

@@ -0,0 +1,3 @@
+// <auto-generated />
+export {};
+//# sourceMappingURL=server-requests.generated.js.map

package/dist/generated/appserver/server-requests.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-requests.generated.js","sourceRoot":"","sources":["../../../src/generated/appserver/server-requests.generated.ts"],"names":[],"mappings":"AAAA,qBAAqB"}

package/dist/generatedAppServer.test.d.ts

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

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

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

package/dist/generatedAppServer.test.js

@@ -0,0 +1,112 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { DotCraftWireClient } from "./client.js";
+import { APP_SERVER_CONTRACT_HASH, APP_SERVER_METHOD_GROUPS, SESSION_ITEM_PAYLOAD_KINDS, isKnownSessionItemPayloadKind, parseSessionItemPayload, } from "./generated/appserver/index.js";
+import { TransportClosed } from "./transport.js";
+class GeneratedBindingTransport {
+    written = [];
+    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();
+        return message ?? await new Promise((resolve) => this.readers.push(resolve));
+    }
+    async writeMessage(message) {
+        this.written.push(message);
+    }
+    async close() {
+        this.closed = true;
+    }
+}
+test("generated method maps type and execute a low-level request", async () => {
+    const transport = new GeneratedBindingTransport();
+    const client = new DotCraftWireClient(transport);
+    if (false) {
+        // @ts-expect-error Unknown methods must use requestRaw().
+        void client.request("fixture/typo", {});
+    }
+    await client.start();
+    const params = {
+        clientInfo: { name: "fixture-client", version: "1.0" },
+        capabilities: { threadSubscriptions: true },
+    };
+    const pending = client.request("initialize", params);
+    const request = transport.written[0];
+    assert.equal(request.method, "initialize");
+    transport.push({
+        jsonrpc: "2.0",
+        id: request.id,
+        result: {
+            serverInfo: { name: "fixture-server", version: "1.0", protocolVersion: "1" },
+            capabilities: { threadManagement: true, threadSubscriptions: true },
+        },
+    });
+    const result = await pending;
+    assert.equal(result.serverInfo.protocolVersion, "1");
+    assert.ok(APP_SERVER_METHOD_GROUPS.clientRequests.includes("initialize"));
+    assert.match(APP_SERVER_CONTRACT_HASH, /^[0-9a-f]{64}$/);
+    await client.stop();
+});
+test("generated unions discriminate while opaque JSON remains open", () => {
+    const declaration = {
+        type: "function",
+        name: "lookup",
+        description: "Lookup data",
+        inputSchema: { type: "object", futureKeyword: [1, true, null] },
+    };
+    if (declaration.type === "function") {
+        assert.equal(declaration.name, "lookup");
+        const schema = declaration.inputSchema;
+        assert.deepEqual(schema.futureKeyword, [1, true, null]);
+    }
+    else {
+        assert.fail("expected function declaration");
+    }
+});
+test("generated safe integers use the TypeScript number wire type", () => {
+    const usage = {
+        inputTokens: Number.MAX_SAFE_INTEGER,
+        totalTokens: 42,
+    };
+    assert.equal(usage.inputTokens, Number.MAX_SAFE_INTEGER);
+    assert.equal(usage.totalTokens, 42);
+});
+test("generated item payload catalog preserves known, unknown, null, and missing values", () => {
+    assert.equal(SESSION_ITEM_PAYLOAD_KINDS.length, 16);
+    assert.equal(new Set(SESSION_ITEM_PAYLOAD_KINDS).size, 16);
+    assert.ok(isKnownSessionItemPayloadKind("agentMessage"));
+    assert.ok(!isKnownSessionItemPayloadKind("futurePayload"));
+    const raw = { text: "typed", futureField: { kept: true } };
+    const known = parseSessionItemPayload("agentMessage", raw);
+    assert.equal(known.isKnown, true);
+    if (known.isKnown) {
+        const value = known.value;
+        assert.equal(value.text, "typed");
+        assert.deepEqual(value.futureField, { kept: true });
+        assert.equal(known.raw, raw);
+    }
+    const unknownRaw = { future: [1, true, null] };
+    const unknown = parseSessionItemPayload("futurePayload", unknownRaw);
+    assert.equal(unknown.isKnown, false);
+    assert.equal(unknown.raw, unknownRaw);
+    assert.equal(unknown.value, unknownRaw);
+    const explicitNull = parseSessionItemPayload("agentMessage", null);
+    assert.equal(explicitNull.isKnown, true);
+    assert.equal(explicitNull.raw, null);
+    assert.equal(explicitNull.value, null);
+    const missing = parseSessionItemPayload("agentMessage", undefined);
+    assert.equal(missing.isKnown, true);
+    assert.equal(missing.raw, undefined);
+    assert.equal(missing.value, null);
+});
+//# sourceMappingURL=generatedAppServer.test.js.map

package/dist/generatedAppServer.test.js.map

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

package/dist/hub.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Hub discovery, startup, management, and SSE helpers.
+ */
+export { HubClient, HubClientError, defaultChatWorkspacePath, ensureDefaultChatWorkspace, findSseBoundary, hubLockPath, isLoopbackHost, isProcessAlive, parseHubBaseUrl, readHubLockFromPath, } from "./hubClient.js";
+export type { HubAppServerResponse, HubBinaryMatchPolicy, HubCapabilities, HubClientInfo, HubClientOptions, HubEnsureAppServerOptions, HubEvent, HubLockInfo, HubManagedServiceResponse, HubEnsureManagedServiceOptions, HubRuntimeToolsRequest, HubServiceStatus, HubStatusResponse, } from "./hubClient.js";
+//# sourceMappingURL=hub.d.ts.map

package/dist/hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub.d.ts","sourceRoot":"","sources":["../src/hub.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,SAAS,EACT,cAAc,EACd,wBAAwB,EACxB,0BAA0B,EAC1B,eAAe,EACf,WAAW,EACX,cAAc,EACd,cAAc,EACd,eAAe,EACf,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,yBAAyB,EACzB,QAAQ,EACR,WAAW,EACX,yBAAyB,EACzB,8BAA8B,EAC9B,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC"}

package/dist/hub.js

@@ -0,0 +1,5 @@
+/**
+ * Hub discovery, startup, management, and SSE helpers.
+ */
+export { HubClient, HubClientError, defaultChatWorkspacePath, ensureDefaultChatWorkspace, findSseBoundary, hubLockPath, isLoopbackHost, isProcessAlive, parseHubBaseUrl, readHubLockFromPath, } from "./hubClient.js";
+//# sourceMappingURL=hub.js.map

package/dist/hub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub.js","sourceRoot":"","sources":["../src/hub.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,SAAS,EACT,cAAc,EACd,wBAAwB,EACxB,0BAA0B,EAC1B,eAAe,EACf,WAAW,EACX,cAAc,EACd,cAAc,EACd,eAAe,EACf,mBAAmB,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/hubClient.d.ts

@@ -0,0 +1,134 @@
+import { DotCraftError } from "./errors.js";
+export interface HubClientOptions {
+    executable?: string;
+    expectedExecutable?: string;
+    binaryMatchPolicy?: HubBinaryMatchPolicy;
+    hubStartupTimeoutMs?: number;
+    hubShutdownTimeoutMs?: number;
+    homeDir?: string;
+}
+export type HubBinaryMatchPolicy = "ignore" | "restartIfMismatch" | "errorIfMismatch";
+export interface HubLockInfo {
+    pid: number;
+    apiBaseUrl: string;
+    token: string;
+    startedAt?: string;
+    version?: string;
+    binaryPath?: string | null;
+}
+export interface HubClientInfo {
+    name?: string;
+    version?: string;
+}
+export interface HubServiceStatus {
+    state: string;
+    url?: string | null;
+    reason?: string | null;
+}
+export interface HubAppServerResponse {
+    workspacePath: string;
+    canonicalWorkspacePath: string;
+    state: string;
+    pid?: number | null;
+    endpoints: Record<string, string>;
+    serviceStatus: Record<string, HubServiceStatus>;
+    serverVersion?: string | null;
+    startedByHub: boolean;
+    exitCode?: number | null;
+    lastError?: string | null;
+    recentStderr?: string | null;
+}
+export interface HubStatusResponse {
+    hubVersion: string;
+    pid: number;
+    startedAt: string;
+    statePath: string;
+    apiBaseUrl: string;
+    binaryPath?: string | null;
+    capabilities: HubCapabilities;
+}
+export interface HubCapabilities {
+    appServerManagement: boolean;
+    managedServiceManagement?: boolean;
+    portManagement: boolean;
+    events: boolean;
+    notifications: boolean;
+    tray: boolean;
+    [key: string]: unknown;
+}
+export interface HubManagedServiceResponse {
+    serviceId: string;
+    state: string;
+    pid?: number | null;
+    endpoint?: string | null;
+    accessToken?: string | null;
+    version?: string | null;
+    lastError?: string | null;
+    recentStderr?: string | null;
+}
+export interface HubEnsureManagedServiceOptions {
+    executable?: string;
+    startIfMissing?: boolean;
+}
+export interface HubEvent {
+    kind: string;
+    at: string;
+    workspacePath?: string | null;
+    data?: unknown;
+}
+export interface HubRuntimeToolsRequest {
+    ripgrepPath?: string;
+    nodeBin?: string;
+    nodeRunAsNode?: boolean;
+    modulesDir?: string;
+    builtInPluginRoots?: string;
+    defaultPluginRegistryUrl?: string;
+}
+export interface HubEnsureAppServerOptions {
+    client?: HubClientInfo;
+    clientName?: string;
+    clientVersion?: string;
+    startIfMissing?: boolean;
+    runtimeTools?: HubRuntimeToolsRequest;
+}
+export declare class HubClientError extends DotCraftError {
+    readonly details?: unknown;
+    constructor(code: string, message: string, details?: unknown, cause?: unknown);
+}
+export declare function hubLockPath(homeDir?: string): string;
+export declare function defaultChatWorkspacePath(homeDir?: string): string;
+export declare function ensureDefaultChatWorkspace(homeDir?: string): string;
+export declare function readHubLockFromPath(path: string): HubLockInfo | null;
+export declare function isProcessAlive(pid: number): boolean;
+export declare function isLoopbackHost(host: string): boolean;
+export declare function parseHubBaseUrl(rawUrl: string): URL;
+export declare function findSseBoundary(buffer: string): {
+    index: number;
+    sequence: "\n\n" | "\r\n\r\n";
+} | null;
+export declare class HubClient {
+    private readonly options;
+    constructor(options?: HubClientOptions);
+    ensureAppServer(workspacePath: string, options?: HubEnsureAppServerOptions): Promise<HubAppServerResponse>;
+    getAppServerByWorkspace(workspacePath: string): Promise<HubAppServerResponse | null>;
+    restartAppServer(workspacePath: string, runtimeTools?: HubRuntimeToolsRequest): Promise<HubAppServerResponse>;
+    stopAppServer(workspacePath: string): Promise<HubAppServerResponse>;
+    listAppServers(): Promise<HubAppServerResponse[]>;
+    ensureManagedService(serviceId: string, options?: HubEnsureManagedServiceOptions): Promise<HubManagedServiceResponse>;
+    getManagedService(serviceId: string): Promise<HubManagedServiceResponse>;
+    restartManagedService(serviceId: string, executable: string): Promise<HubManagedServiceResponse>;
+    stopManagedService(serviceId: string): Promise<HubManagedServiceResponse>;
+    ensureDefaultChatAppServer(options?: HubEnsureAppServerOptions): Promise<HubAppServerResponse>;
+    getStatus(): Promise<HubStatusResponse>;
+    shutdownHub(): Promise<void>;
+    subscribeEvents(onEvent: (event: HubEvent) => void, signal: AbortSignal): Promise<void>;
+    ensureHub(): Promise<HubLockInfo>;
+    tryGetLiveHub(): Promise<HubLockInfo | null>;
+    private startHub;
+    private requestJson;
+    private toError;
+    private get binaryMatchPolicy();
+    private getBinaryMismatch;
+    private shutdownMismatchedHub;
+}
+//# sourceMappingURL=hubClient.d.ts.map

package/dist/hubClient.d.ts.map

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