@theway-ai/sdk 1.1.0

package/README.md

@@ -0,0 +1,102 @@
+# @theway-ai/sdk
+
+Typed TypeScript SDK for the **theway** gRPC daemon (`theway --grpc` loopback server).
+Generated from the five domain protos
+([`proto/commands.proto`](proto/commands.proto),
+[`proto/session.proto`](proto/session.proto),
+[`proto/graph_engine.proto`](proto/graph_engine.proto),
+[`proto/events.proto`](proto/events.proto),
+[`proto/settings.proto`](proto/settings.proto)) + [`proto/health.proto`](proto/health.proto)
+via ts-proto + `@grpc/grpc-js` — **no runtime proto loading**, no path magic.
+
+`ThewayGrpcClient` routes each RPC to its domain service — `CommandService`,
+`SessionService`, `SettingsService`, `GraphEngineService`, and `EventService` — while
+`HealthClient` covers the standard `grpc.health.v1.Health` service.
+
+Published as a public package on the official npm registry (`https://registry.npmjs.org/`).
+
+## Install
+
+```sh
+npm install @theway-ai/sdk
+```
+
+## Usage
+
+```ts
+import { ThewayGrpcClient, HealthClient } from '@theway-ai/sdk';
+
+const client = new ThewayGrpcClient('http://127.0.0.1:34567');
+
+// Full session state (typed SessionState)
+const state = await client.getState();
+
+// Commands — throw when the server replies accepted: false
+await client.prompt('hello');
+await client.setModelSpec('anthropic:claude-sonnet-4-5');
+await client.abort();
+await client.resolveControlPlane(true);
+
+// Graph / session control
+const { resetNodeIds } = await client.graphRetry('dag-1');
+const sessions = await client.listSessions();
+
+// Daemon settings (issue #72) — partial update: only set fields are applied
+const config = await client.getConfig();
+await client.setConfig({ triggerPollSecs: 30, skillsDirs: ['/extra/skills'] });
+
+// Snapshot + event stream (StreamFrame oneof: payload.$case === 'snapshot' | 'event')
+await client.streamEvents((frame) => {
+  if (frame.payload?.$case === 'snapshot') {
+    console.log(frame.payload.snapshot.feedLines?.length);
+  }
+}, abortSignal);
+
+// Standard gRPC health probe (grpc.health.v1)
+const health = new HealthClient('127.0.0.1:34567');
+const serving = await health.check('');
+
+client.close();
+```
+
+## Regenerating
+
+`crates/theway-transport/proto/` at the repo root is the single source of truth; `proto/*.proto` in this package is a mirror and
+`src/generated/` is regenerated from it. Sync and regenerate with:
+
+```sh
+cd ../..                   # repo root
+make hooks                 # once per clone: enable the pre-commit hook
+make sdk-sync              # or: bash scripts/sdk-sync.sh
+```
+
+The enabled pre-commit hook ([`.githooks/pre-commit`](../../.githooks/pre-commit)) runs the sync automatically
+whenever `crates/theway-transport/proto/` changes and stages the regenerated files into the same commit, so the checked-in proto and
+generated client never drift.
+
+Manual generation without the Makefile:
+
+```sh
+npm install
+npm run gen      # protoc (grpc-tools) + ts-proto → src/generated/
+```
+
+## Publishing
+
+Publishing to the official npm registry is manual ([`scripts/sdk-publish.sh`](../../scripts/sdk-publish.sh)):
+
+```sh
+cd ../..
+make sdk-publish BUMP=minor ISSUE="#62"
+# 或: bash scripts/sdk-publish.sh minor "#62"
+```
+
+The script verifies the tree is clean and in sync, checks the active npm identity against the official
+registry, bumps the version, publishes with public access, and commits the version bump. Run
+`npm login --registry=https://registry.npmjs.org/` before invoking it; the account must satisfy npm's
+two-factor authentication requirements for publishing.
+
+## Versioning
+
+The SDK version tracks the theway release that the proto contract was cut from
+(theway v1.0.0 → SDK 1.0.0). Bump together with contract changes.

package/dist/client.d.ts

@@ -0,0 +1,138 @@
+import * as grpc from '@grpc/grpc-js';
+import { type CommandResult, type Empty, type SendMessageRequest } from './generated/commands.js';
+import { type StreamFrame } from './generated/events.js';
+import { type DecideExtensionTrustRequest, type DecideExtensionTrustResponse, type ExtensionCommandOutcome, type ExtensionSnapshot, type InvokeExtensionCommandRequest, type ReloadExtensionsRequest, type ReloadExtensionsResponse } from './generated/extensions.js';
+import { type GetNodeOutputRequest, type GetNodeOutputResponse, type GraphCheckpointRequest, type GraphCheckpointResponse, type GraphListResponse, type GraphRestoreResponse, type GraphRetryResponse, type GraphSkipResponse } from './generated/graph_engine.js';
+import { type CreateSessionRequest, type CreateSessionResponse, type DeleteSessionRequest, type DeleteSessionResponse, type ListSessionsResponse, type RenameSessionRequest, type SessionState } from './generated/session.js';
+import { type DaemonConfig } from './generated/settings.js';
+import { type EditFileRequest, type EditFileResponse, type ExecCommandRequest, type FindRequest, type FindResponse, type GrepRequest, type GrepResponse, type ListDirRequest, type ListDirResponse, type MemoryForgetRequest, type MemoryForgetResponse, type MemoryListRequest, type MemoryListResponse, type MemoryReadRequest, type MemoryReadResponse, type MemorySaveRequest, type MemorySaveResponse, type ReadFileRequest, type ReadFileResponse, type SkillInstallRequest, type SkillInstallResponse, type WriteFileRequest, type WriteFileResponse } from './generated/tools.js';
+import { type LoadCronJobsRequest, type LoadCronJobsResponse, type LoadDagRunsRequest, type LoadDagRunsResponse, type LoadTriggerRulesRequest, type LoadTriggerRulesResponse, type SaveCronJobsRequest, type SaveCronJobsResponse, type SaveDagRunRequest, type SaveDagRunResponse, type SaveTriggerRulesRequest, type SaveTriggerRulesResponse } from './generated/state.js';
+/**
+ * Typed gRPC client for the `theway --grpc` loopback server
+ * (theway.grpc.v1.CommandService / SessionService / SettingsService /
+ * ExtensionService / ToolService / StorageService / GraphEngineService /
+ * EventService).
+ * Generated from the domain proto files
+ * and health.proto (ts-proto + @grpc/grpc-js) — no runtime proto loading.
+ *
+ * Command RPCs (SendMessage / SetModel / …) resolve the raw CommandResult;
+ * the convenience wrappers (`prompt`, `setModelSpec`, `abort`, …) throw when
+ * the server replies `accepted: false`, mirroring the caller-side contract of
+ * the JSON channels.
+ */
+export declare class ThewayGrpcClient {
+    #private;
+    constructor(baseUrl: string, credentials?: grpc.ChannelCredentials);
+    /** `GetState` — the latest full session state. */
+    getState(): Promise<SessionState>;
+    /** `GetNodeOutput` — a DAG node's output fragment from an offset. */
+    getNodeOutput(request: GetNodeOutputRequest): Promise<GetNodeOutputResponse>;
+    /** `SendMessage` — submit a user prompt (mode=QUEUE). */
+    prompt(text: string, images?: SendMessageRequest['images']): Promise<void>;
+    /** `SendMessage` — raw request (mode=INTERRUPT supported). */
+    sendMessage(request: SendMessageRequest): Promise<CommandResult>;
+    /** `SetModel` — switch model with a composed `provider:model` spec. */
+    setModelSpec(spec: string): Promise<void>;
+    /** `SetModel` with `provider` + `model` (composed into `provider:model`). */
+    setModel(provider: string, model: string): Promise<void>;
+    /** `Cancel` — stop the in-flight turn (same as local Ctrl-C). */
+    abort(): Promise<void>;
+    /** `Approve` — resolve the pending control-plane approval (approve / reject). */
+    resolveControlPlane(approve: boolean): Promise<void>;
+    /** Structured extension catalog, redacted diagnostics and contributions. */
+    getExtensions(): Promise<ExtensionSnapshot>;
+    /** Invoke a registered extension command in either interactive or headless mode. */
+    invokeExtensionCommand(request: InvokeExtensionCommandRequest): Promise<ExtensionCommandOutcome>;
+    /** Re-discover extensions; active work may return `status=pending`. */
+    reloadExtensions(request?: ReloadExtensionsRequest): Promise<ReloadExtensionsResponse>;
+    /** Persist a project or exact-package trust decision and request reload. */
+    decideExtensionTrust(request: DecideExtensionTrustRequest): Promise<DecideExtensionTrustResponse>;
+    /** `GraphCancel` — cancel a run. */
+    graphCancel(runId: string): Promise<void>;
+    /** `GraphRetry` — re-run failed/cancelled nodes (omitted nodeId = all). */
+    graphRetry(runId: string, nodeId?: string): Promise<GraphRetryResponse>;
+    /** `GraphSkip` — skip a node (counts as success for downstream). */
+    graphSkip(runId: string, nodeId: string): Promise<GraphSkipResponse>;
+    /** `GraphNodeInterrupt` — stop the node's in-flight turn. */
+    graphNodeInterrupt(runId: string, nodeId: string): Promise<void>;
+    /** `GraphNodeSteer` — queue a steering message at the node's next turn boundary. */
+    graphNodeSteer(runId: string, nodeId: string, text: string): Promise<void>;
+    /** `GraphCheckpoint` — export run snapshots as portable JSON. */
+    graphCheckpoint(request?: GraphCheckpointRequest): Promise<GraphCheckpointResponse>;
+    /** `GraphRestore` — revive a run from a GraphCheckpoint snapshot. */
+    graphRestore(sessionId: string, snapshot: string): Promise<GraphRestoreResponse>;
+    /** `GraphList` — enumerate one session's graph runs. */
+    graphList(sessionId: string): Promise<GraphListResponse>;
+    /** `ListSessions` — all sessions (live + archived) with the current one marked. */
+    listSessions(): Promise<ListSessionsResponse>;
+    /** `CreateSession` — create a session. */
+    createSession(name?: string): Promise<CreateSessionResponse>;
+    /** `SwitchSession` — switch the live session. */
+    switchSession(sessionId: string): Promise<void>;
+    /** `RenameSession` — rename a session. */
+    renameSession(sessionId: string, name: string): Promise<void>;
+    /** `DeleteSession` — delete a session (refused while graphs are running). */
+    deleteSession(sessionId: string): Promise<DeleteSessionResponse>;
+    /** `GetConfig` — the daemon's current configuration view. */
+    getConfig(): Promise<DaemonConfig>;
+    /**
+     * `SetConfig` — push a partial configuration update. Absent fields keep
+     * the daemon's current value (repeated fields default to empty = no-op).
+     */
+    setConfig(config: Partial<DaemonConfig>): Promise<void>;
+    /** `Configure` — alias of `setConfig` (JSON-RPC / WS / MCP verb alignment). */
+    configure(config: Partial<DaemonConfig>): Promise<void>;
+    /** `ReadFile` — read a file with line pagination. */
+    toolRead(request: ReadFileRequest): Promise<ReadFileResponse>;
+    /** `WriteFile` — write a file. */
+    toolWrite(request: WriteFileRequest): Promise<WriteFileResponse>;
+    /** `EditFile` — search-and-replace edit. */
+    toolEdit(request: EditFileRequest): Promise<EditFileResponse>;
+    /** `ExecCommand` — streaming shell execution. */
+    toolExec(request: ExecCommandRequest): grpc.ClientReadableStream<import("./generated/tools.js").ExecOutputFrame>;
+    /** `ListDir` — list one directory level. */
+    toolListDir(request: ListDirRequest): Promise<ListDirResponse>;
+    /** `Grep` — regex content search. */
+    toolGrep(request: GrepRequest): Promise<GrepResponse>;
+    /** `Find` — filename-glob search. */
+    toolFind(request: FindRequest): Promise<FindResponse>;
+    /** `MemorySave` — save a memory entry. */
+    toolMemorySave(request: MemorySaveRequest): Promise<MemorySaveResponse>;
+    /** `MemoryList` — list memory entries. */
+    toolMemoryList(request: MemoryListRequest): Promise<MemoryListResponse>;
+    /** `MemoryRead` — read one memory entry. */
+    toolMemoryRead(request: MemoryReadRequest): Promise<MemoryReadResponse>;
+    /** `MemoryForget` — forget a memory entry. */
+    toolMemoryForget(request: MemoryForgetRequest): Promise<MemoryForgetResponse>;
+    /** `SkillInstall` — two-phase skill install. */
+    toolSkillInstall(request: SkillInstallRequest): Promise<SkillInstallResponse>;
+    /** `StorageService.ListSessions` — session list from external storage. */
+    stateListSessions(request: Empty): Promise<import('./generated/session.js').ListSessionsResponse>;
+    /** `StorageService.CreateSession` — create a session in external storage. */
+    stateCreateSession(request: CreateSessionRequest): Promise<CreateSessionResponse>;
+    /** `StorageService.RenameSession` — rename a session in external storage. */
+    stateRenameSession(request: RenameSessionRequest): Promise<CommandResult>;
+    /** `StorageService.DeleteSession` — delete a session in external storage. */
+    stateDeleteSession(request: DeleteSessionRequest): Promise<DeleteSessionResponse>;
+    /** `StorageService.SaveDagRun` — persist a DAG run. */
+    stateSaveDagRun(request: SaveDagRunRequest): Promise<SaveDagRunResponse>;
+    /** `StorageService.LoadDagRuns` — load persisted DAG runs. */
+    stateLoadDagRuns(request: LoadDagRunsRequest): Promise<LoadDagRunsResponse>;
+    /** `StorageService.SaveTriggerRules` — persist trigger rules. */
+    stateSaveTriggerRules(request: SaveTriggerRulesRequest): Promise<SaveTriggerRulesResponse>;
+    /** `StorageService.LoadTriggerRules` — load persisted trigger rules. */
+    stateLoadTriggerRules(request: LoadTriggerRulesRequest): Promise<LoadTriggerRulesResponse>;
+    /** `StorageService.SaveCronJobs` — persist cron jobs. */
+    stateSaveCronJobs(request: SaveCronJobsRequest): Promise<SaveCronJobsResponse>;
+    /** `StorageService.LoadCronJobs` — load persisted cron jobs. */
+    stateLoadCronJobs(request: LoadCronJobsRequest): Promise<LoadCronJobsResponse>;
+    /**
+     * `StreamEvents` — server-streaming snapshot/event frames. Every frame
+     * (snapshot and event) is delivered to `onFrame`. Resolves when the stream
+     * ends normally; rejects on transport errors or when the client is closed.
+     */
+    streamEvents(onFrame: (frame: StreamFrame) => void, signal?: AbortSignal): Promise<void>;
+    /** Close the underlying channel; in-flight streams fail fast. */
+    close(): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AACtC,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,KAAK,EACV,KAAK,kBAAkB,EAExB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAGL,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC9B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAE1B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAE5B,KAAK,iBAAiB,EAItB,KAAK,oBAAoB,EAEzB,KAAK,kBAAkB,EAEvB,KAAK,iBAAiB,EACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EAElB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC9B,MAAM,sBAAsB,CAAC;AAO9B;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB;;gBAWzB,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,IAAI,CAAC,kBAAsD;IAe1E,kDAAkD;IAClD,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IAIjC,qEAAqE;IACrE,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAM5E,yDAAyD;IACnD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,kBAAkB,CAAC,QAAQ,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpF,8DAA8D;IAC9D,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IAIhE,uEAAuE;IACjE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/C,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD,iEAAiE;IAC3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,iFAAiF;IAC3E,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAc1D,4EAA4E;IAC5E,aAAa,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAQ3C,oFAAoF;IACpF,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAQhG,uEAAuE;IACvE,gBAAgB,CAAC,OAAO,GAAE,uBAAiD,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAQ/G,4EAA4E;IAC5E,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAUjG,oCAAoC;IAC9B,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/C,2EAA2E;IAC3E,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAKvE,oEAAoE;IACpE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKpE,6DAA6D;IACvD,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtE,oFAAoF;IAC9E,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYhF,iEAAiE;IACjE,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAIvF,qEAAqE;IACrE,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAKhF,wDAAwD;IACxD,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOxD,mFAAmF;IACnF,YAAY,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAI7C,0CAA0C;IAC1C,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAK5D,iDAAiD;IAC3C,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYrD,0CAA0C;IACpC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnE,6EAA6E;IAC7E,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAOhE,6DAA6D;IAC7D,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC;IAIlC;;;OAGG;IACG,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7D,+EAA+E;IACzE,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAa7D,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI7D,kCAAkC;IAClC,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIhE,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI7D,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,kBAAkB;IAIpC,4CAA4C;IAC5C,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAI9D,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAIrD,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAIrD,0CAA0C;IAC1C,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIvE,0CAA0C;IAC1C,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIvE,4CAA4C;IAC5C,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIvE,8CAA8C;IAC9C,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAI7E,gDAAgD;IAChD,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAM7E,0EAA0E;IAC1E,iBAAiB,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,wBAAwB,EAAE,oBAAoB,CAAC;IAIjG,6EAA6E;IAC7E,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIjF,6EAA6E;IAC7E,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IAIzE,6EAA6E;IAC7E,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIjF,uDAAuD;IACvD,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIxE,8DAA8D;IAC9D,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI3E,iEAAiE;IACjE,qBAAqB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAI1F,wEAAwE;IACxE,qBAAqB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAI1F,yDAAyD;IACzD,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAI9E,gEAAgE;IAChE,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAM9E;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAyCxF,iEAAiE;IACjE,KAAK,IAAI,IAAI;CAsCd"}

package/dist/client.js

@@ -0,0 +1,390 @@
+import * as grpc from '@grpc/grpc-js';
+import { CommandServiceClient as CommandServiceClientCtor, MessageMode, } from './generated/commands.js';
+import { EventServiceClient as EventServiceClientCtor, } from './generated/events.js';
+import { ExtensionServiceClient as ExtensionServiceClientCtor, } from './generated/extensions.js';
+import { GraphEngineServiceClient as GraphEngineServiceClientCtor, } from './generated/graph_engine.js';
+import { SessionServiceClient as SessionServiceClientCtor, } from './generated/session.js';
+import { SettingsServiceClient as SettingsServiceClientCtor, } from './generated/settings.js';
+import { ToolServiceClient as ToolServiceClientCtor, } from './generated/tools.js';
+import { StorageServiceClient as StorageServiceClientCtor, } from './generated/state.js';
+// ── authority cleaning ──
+const SCHEME_PREFIX = /^https?:\/\//;
+const TRAILING_SLASHES = /\/+$/;
+/**
+ * Typed gRPC client for the `theway --grpc` loopback server
+ * (theway.grpc.v1.CommandService / SessionService / SettingsService /
+ * ExtensionService / ToolService / StorageService / GraphEngineService /
+ * EventService).
+ * Generated from the domain proto files
+ * and health.proto (ts-proto + @grpc/grpc-js) — no runtime proto loading.
+ *
+ * Command RPCs (SendMessage / SetModel / …) resolve the raw CommandResult;
+ * the convenience wrappers (`prompt`, `setModelSpec`, `abort`, …) throw when
+ * the server replies `accepted: false`, mirroring the caller-side contract of
+ * the JSON channels.
+ */
+export class ThewayGrpcClient {
+    #session;
+    #command;
+    #extensions;
+    #graph;
+    #events;
+    #settings;
+    #tools;
+    #storage;
+    constructor(baseUrl, credentials = grpc.credentials.createInsecure()) {
+        const authority = baseUrl.replace(SCHEME_PREFIX, '').replace(TRAILING_SLASHES, '');
+        this.#session = new SessionServiceClientCtor(authority, credentials);
+        this.#command = new CommandServiceClientCtor(authority, credentials);
+        this.#extensions = new ExtensionServiceClientCtor(authority, credentials);
+        this.#graph = new GraphEngineServiceClientCtor(authority, credentials);
+        this.#events = new EventServiceClientCtor(authority, credentials);
+        this.#settings = new SettingsServiceClientCtor(authority, credentials);
+        this.#tools = new ToolServiceClientCtor(authority, credentials);
+        this.#storage = new StorageServiceClientCtor(authority, credentials);
+    }
+    // ── session state ──
+    /** `GetState` — the latest full session state. */
+    getState() {
+        return this.#call(this.#session.getState.bind(this.#session), 'GetState', {});
+    }
+    /** `GetNodeOutput` — a DAG node's output fragment from an offset. */
+    getNodeOutput(request) {
+        return this.#call(this.#graph.getNodeOutput.bind(this.#graph), 'GetNodeOutput', request);
+    }
+    // ── commands ──
+    /** `SendMessage` — submit a user prompt (mode=QUEUE). */
+    async prompt(text, images = []) {
+        const request = { text, images, mode: MessageMode.QUEUE };
+        const result = await this.sendMessage(request);
+        if (!result.accepted) {
+            throw new Error('theway grpc: SendMessage was not accepted by the server');
+        }
+    }
+    /** `SendMessage` — raw request (mode=INTERRUPT supported). */
+    sendMessage(request) {
+        return this.#call(this.#command.sendMessage.bind(this.#command), 'SendMessage', request);
+    }
+    /** `SetModel` — switch model with a composed `provider:model` spec. */
+    async setModelSpec(spec) {
+        const request = { spec };
+        const result = await this.#call(this.#command.setModel.bind(this.#command), 'SetModel', request);
+        if (!result.accepted) {
+            throw new Error('theway grpc: SetModel was not accepted by the server');
+        }
+    }
+    /** `SetModel` with `provider` + `model` (composed into `provider:model`). */
+    setModel(provider, model) {
+        return this.setModelSpec(`${provider}:${model}`);
+    }
+    /** `Cancel` — stop the in-flight turn (same as local Ctrl-C). */
+    async abort() {
+        const result = await this.#call(this.#command.cancel.bind(this.#command), 'Cancel', {});
+        if (!result.accepted) {
+            throw new Error('theway grpc: Cancel was not accepted by the server');
+        }
+    }
+    /** `Approve` — resolve the pending control-plane approval (approve / reject). */
+    async resolveControlPlane(approve) {
+        const request = { approve };
+        const result = await this.#call(this.#command.approve.bind(this.#command), 'Approve', request);
+        if (!result.accepted) {
+            throw new Error('theway grpc: Approve was not accepted by the server');
+        }
+    }
+    // ── runtime extensions ──
+    /** Structured extension catalog, redacted diagnostics and contributions. */
+    getExtensions() {
+        return this.#call(this.#extensions.getExtensions.bind(this.#extensions), 'GetExtensions', {});
+    }
+    /** Invoke a registered extension command in either interactive or headless mode. */
+    invokeExtensionCommand(request) {
+        return this.#call(this.#extensions.invokeCommand.bind(this.#extensions), 'InvokeExtensionCommand', request);
+    }
+    /** Re-discover extensions; active work may return `status=pending`. */
+    reloadExtensions(request = { cancelActive: false }) {
+        return this.#call(this.#extensions.reload.bind(this.#extensions), 'ReloadExtensions', request);
+    }
+    /** Persist a project or exact-package trust decision and request reload. */
+    decideExtensionTrust(request) {
+        return this.#call(this.#extensions.decideTrust.bind(this.#extensions), 'DecideExtensionTrust', request);
+    }
+    // ── graph control (DAG + goal runs) ──
+    /** `GraphCancel` — cancel a run. */
+    async graphCancel(runId) {
+        const request = { runId };
+        const result = await this.#call(this.#graph.graphCancel.bind(this.#graph), 'GraphCancel', request);
+        if (!result.accepted) {
+            throw new Error('theway grpc: GraphCancel was not accepted by the server');
+        }
+    }
+    /** `GraphRetry` — re-run failed/cancelled nodes (omitted nodeId = all). */
+    graphRetry(runId, nodeId) {
+        const request = { runId, nodeId };
+        return this.#call(this.#graph.graphRetry.bind(this.#graph), 'GraphRetry', request);
+    }
+    /** `GraphSkip` — skip a node (counts as success for downstream). */
+    graphSkip(runId, nodeId) {
+        const request = { runId, nodeId };
+        return this.#call(this.#graph.graphSkip.bind(this.#graph), 'GraphSkip', request);
+    }
+    /** `GraphNodeInterrupt` — stop the node's in-flight turn. */
+    async graphNodeInterrupt(runId, nodeId) {
+        const request = { runId, nodeId };
+        const result = await this.#call(this.#graph.graphNodeInterrupt.bind(this.#graph), 'GraphNodeInterrupt', request);
+        if (!result.accepted) {
+            throw new Error('theway grpc: GraphNodeInterrupt was not accepted by the server');
+        }
+    }
+    /** `GraphNodeSteer` — queue a steering message at the node's next turn boundary. */
+    async graphNodeSteer(runId, nodeId, text) {
+        const request = { runId, nodeId, text };
+        const result = await this.#call(this.#graph.graphNodeSteer.bind(this.#graph), 'GraphNodeSteer', request);
+        if (!result.accepted) {
+            throw new Error('theway grpc: GraphNodeSteer was not accepted by the server');
+        }
+    }
+    /** `GraphCheckpoint` — export run snapshots as portable JSON. */
+    graphCheckpoint(request = {}) {
+        return this.#call(this.#graph.graphCheckpoint.bind(this.#graph), 'GraphCheckpoint', request);
+    }
+    /** `GraphRestore` — revive a run from a GraphCheckpoint snapshot. */
+    graphRestore(sessionId, snapshot) {
+        const request = { sessionId, snapshot };
+        return this.#call(this.#graph.graphRestore.bind(this.#graph), 'GraphRestore', request);
+    }
+    /** `GraphList` — enumerate one session's graph runs. */
+    graphList(sessionId) {
+        const request = { sessionId };
+        return this.#call(this.#graph.graphList.bind(this.#graph), 'GraphList', request);
+    }
+    // ── session resources ──
+    /** `ListSessions` — all sessions (live + archived) with the current one marked. */
+    listSessions() {
+        return this.#call(this.#session.listSessions.bind(this.#session), 'ListSessions', {});
+    }
+    /** `CreateSession` — create a session. */
+    createSession(name) {
+        const request = { name };
+        return this.#call(this.#session.createSession.bind(this.#session), 'CreateSession', request);
+    }
+    /** `SwitchSession` — switch the live session. */
+    async switchSession(sessionId) {
+        const request = { sessionId };
+        const result = await this.#call(this.#session.switchSession.bind(this.#session), 'SwitchSession', request);
+        if (!result.accepted) {
+            throw new Error('theway grpc: SwitchSession was not accepted by the server');
+        }
+    }
+    /** `RenameSession` — rename a session. */
+    async renameSession(sessionId, name) {
+        const request = { sessionId, name };
+        const result = await this.#call(this.#session.renameSession.bind(this.#session), 'RenameSession', request);
+        if (!result.accepted) {
+            throw new Error('theway grpc: RenameSession was not accepted by the server');
+        }
+    }
+    /** `DeleteSession` — delete a session (refused while graphs are running). */
+    deleteSession(sessionId) {
+        const request = { sessionId };
+        return this.#call(this.#session.deleteSession.bind(this.#session), 'DeleteSession', request);
+    }
+    // ── settings / config ──
+    /** `GetConfig` — the daemon's current configuration view. */
+    getConfig() {
+        return this.#call(this.#settings.getConfig.bind(this.#settings), 'GetConfig', {});
+    }
+    /**
+     * `SetConfig` — push a partial configuration update. Absent fields keep
+     * the daemon's current value (repeated fields default to empty = no-op).
+     */
+    async setConfig(config) {
+        const result = await this.#call(this.#settings.setConfig.bind(this.#settings), 'SetConfig', fillDaemonConfig(config));
+        if (!result.accepted) {
+            throw new Error('theway grpc: SetConfig was not accepted by the server');
+        }
+    }
+    /** `Configure` — alias of `setConfig` (JSON-RPC / WS / MCP verb alignment). */
+    async configure(config) {
+        const result = await this.#call(this.#settings.configure.bind(this.#settings), 'Configure', fillDaemonConfig(config));
+        if (!result.accepted) {
+            throw new Error('theway grpc: Configure was not accepted by the server');
+        }
+    }
+    // ── tool operations ──
+    /** `ReadFile` — read a file with line pagination. */
+    toolRead(request) {
+        return this.#call(this.#tools.readFile.bind(this.#tools), 'ReadFile', request);
+    }
+    /** `WriteFile` — write a file. */
+    toolWrite(request) {
+        return this.#call(this.#tools.writeFile.bind(this.#tools), 'WriteFile', request);
+    }
+    /** `EditFile` — search-and-replace edit. */
+    toolEdit(request) {
+        return this.#call(this.#tools.editFile.bind(this.#tools), 'EditFile', request);
+    }
+    /** `ExecCommand` — streaming shell execution. */
+    toolExec(request) {
+        return this.#tools.execCommand(request);
+    }
+    /** `ListDir` — list one directory level. */
+    toolListDir(request) {
+        return this.#call(this.#tools.listDir.bind(this.#tools), 'ListDir', request);
+    }
+    /** `Grep` — regex content search. */
+    toolGrep(request) {
+        return this.#call(this.#tools.grep.bind(this.#tools), 'Grep', request);
+    }
+    /** `Find` — filename-glob search. */
+    toolFind(request) {
+        return this.#call(this.#tools.find.bind(this.#tools), 'Find', request);
+    }
+    /** `MemorySave` — save a memory entry. */
+    toolMemorySave(request) {
+        return this.#call(this.#tools.memorySave.bind(this.#tools), 'MemorySave', request);
+    }
+    /** `MemoryList` — list memory entries. */
+    toolMemoryList(request) {
+        return this.#call(this.#tools.memoryList.bind(this.#tools), 'MemoryList', request);
+    }
+    /** `MemoryRead` — read one memory entry. */
+    toolMemoryRead(request) {
+        return this.#call(this.#tools.memoryRead.bind(this.#tools), 'MemoryRead', request);
+    }
+    /** `MemoryForget` — forget a memory entry. */
+    toolMemoryForget(request) {
+        return this.#call(this.#tools.memoryForget.bind(this.#tools), 'MemoryForget', request);
+    }
+    /** `SkillInstall` — two-phase skill install. */
+    toolSkillInstall(request) {
+        return this.#call(this.#tools.skillInstall.bind(this.#tools), 'SkillInstall', request);
+    }
+    // ── runtime state storage ──
+    /** `StorageService.ListSessions` — session list from external storage. */
+    stateListSessions(request) {
+        return this.#call(this.#storage.listSessions.bind(this.#storage), 'ListSessions', request);
+    }
+    /** `StorageService.CreateSession` — create a session in external storage. */
+    stateCreateSession(request) {
+        return this.#call(this.#storage.createSession.bind(this.#storage), 'CreateSession', request);
+    }
+    /** `StorageService.RenameSession` — rename a session in external storage. */
+    stateRenameSession(request) {
+        return this.#call(this.#storage.renameSession.bind(this.#storage), 'RenameSession', request);
+    }
+    /** `StorageService.DeleteSession` — delete a session in external storage. */
+    stateDeleteSession(request) {
+        return this.#call(this.#storage.deleteSession.bind(this.#storage), 'DeleteSession', request);
+    }
+    /** `StorageService.SaveDagRun` — persist a DAG run. */
+    stateSaveDagRun(request) {
+        return this.#call(this.#storage.saveDagRun.bind(this.#storage), 'SaveDagRun', request);
+    }
+    /** `StorageService.LoadDagRuns` — load persisted DAG runs. */
+    stateLoadDagRuns(request) {
+        return this.#call(this.#storage.loadDagRuns.bind(this.#storage), 'LoadDagRuns', request);
+    }
+    /** `StorageService.SaveTriggerRules` — persist trigger rules. */
+    stateSaveTriggerRules(request) {
+        return this.#call(this.#storage.saveTriggerRules.bind(this.#storage), 'SaveTriggerRules', request);
+    }
+    /** `StorageService.LoadTriggerRules` — load persisted trigger rules. */
+    stateLoadTriggerRules(request) {
+        return this.#call(this.#storage.loadTriggerRules.bind(this.#storage), 'LoadTriggerRules', request);
+    }
+    /** `StorageService.SaveCronJobs` — persist cron jobs. */
+    stateSaveCronJobs(request) {
+        return this.#call(this.#storage.saveCronJobs.bind(this.#storage), 'SaveCronJobs', request);
+    }
+    /** `StorageService.LoadCronJobs` — load persisted cron jobs. */
+    stateLoadCronJobs(request) {
+        return this.#call(this.#storage.loadCronJobs.bind(this.#storage), 'LoadCronJobs', request);
+    }
+    // ── event stream ──
+    /**
+     * `StreamEvents` — server-streaming snapshot/event frames. Every frame
+     * (snapshot and event) is delivered to `onFrame`. Resolves when the stream
+     * ends normally; rejects on transport errors or when the client is closed.
+     */
+    streamEvents(onFrame, signal) {
+        return new Promise((resolve, reject) => {
+            const forwardAbort = () => {
+                this.#closed = true;
+                // Cancel the stream by ending the call
+            };
+            signal?.addEventListener('abort', forwardAbort, { once: true });
+            const stream = this.#events.streamEvents.bind(this.#events)({});
+            stream.on('data', (frame) => {
+                try {
+                    onFrame(frame);
+                }
+                catch (err) {
+                    signal?.removeEventListener('abort', forwardAbort);
+                    stream.destroy();
+                    reject(new Error(`theway grpc: StreamEvents handler threw: ${extractErrorMessage(err)}`, { cause: err }));
+                }
+            });
+            stream.on('end', () => {
+                signal?.removeEventListener('abort', forwardAbort);
+                resolve();
+            });
+            stream.on('error', (err) => {
+                signal?.removeEventListener('abort', forwardAbort);
+                if (this.#closed || signal?.aborted) {
+                    reject(new Error('theway grpc: StreamEvents aborted by close()'));
+                }
+                else {
+                    reject(this.#mapError('StreamEvents', err));
+                }
+            });
+        });
+    }
+    /** Close the underlying channel; in-flight streams fail fast. */
+    close() {
+        this.#closed = true;
+        this.#session.close();
+        this.#command.close();
+        this.#extensions.close();
+        this.#graph.close();
+        this.#events.close();
+        this.#settings.close();
+        this.#tools.close();
+        this.#storage.close();
+    }
+    // ── private helpers ──
+    #closed = false;
+    #call(invoke, method, request) {
+        return new Promise((resolve, reject) => {
+            invoke(request, (err, response) => {
+                if (err) {
+                    reject(this.#mapError(method, err));
+                    return;
+                }
+                resolve(response);
+            });
+        });
+    }
+    #mapError(method, err) {
+        return new Error(`theway grpc: ${method} failed: ${err.message}`, { cause: err });
+    }
+}
+function extractErrorMessage(err) {
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+/**
+ * Complete a partial `DaemonConfig` for the wire: ts-proto models proto3
+ * repeated fields as required arrays. Empty value arrays mean "keep" while
+ * `clearFields` carries explicit clear intent.
+ */
+function fillDaemonConfig(config) {
+    return {
+        ...config,
+        builtinSkills: config.builtinSkills ?? [],
+        skillsDirs: config.skillsDirs ?? [],
+        clearFields: config.clearFields ?? [],
+    };
+}
+//# sourceMappingURL=client.js.map