@maiaos/sdk 0.1.0-canary.44938d4.manual.1

package/README.md

@@ -0,0 +1,291 @@
+# `@maiaos/sdk`
+
+> **Publication status:** Source-implemented candidate, canary-only. npm
+> canaries use the
+> `canary` dist-tag for installation evidence and remain
+> `releaseQualified: false`. No stable version or `latest` dist-tag is
+> released.
+
+Transport-neutral client primitives for the Maia protocol.
+
+`@maiaos/sdk` is the only supported node-facing product-client boundary for Maia
+Desktop, web, mobile/tablet, and `@maiaos/cli`:
+
+```text
+product client ──► @maiaos/sdk ── runtime transport ──► maia-node
+                         ╲                              ╱
+                          ╲══ package dependencies ═══╱
+                                  ▼
+                           @maiaos/protocol
+```
+
+Clients own presentation and select a connection profile. SDK transports own
+local IPC or remote HTTP/WSS mechanics; clients must not open a parallel node
+transport, access node storage, or supervise runtimes directly.
+
+The SDK is also the mandatory middle layer for every planned Build,
+Teammates, Rooms, Routines, Skill Studio, Activity, and Advanced Runtime
+Extensions vertical slice. A node handler or CLI parser without the matching
+bounded protocol and transport-neutral SDK operation is not a complete
+headless feature. This includes planned recommendation/install/sync operations
+for the exact-version `maia-cli` and `maia-orchestration` Skill bundles.
+
+The package validates generic request and response envelopes, correlates
+responses, preserves structured protocol errors, and forwards standard
+`AbortSignal` cancellation. Its main export remains transport- and
+platform-neutral. Protocol validation is implemented by Effect Schema behind
+the Maia-owned facade; custom request/output validators still need only a
+synchronous `parse(unknown)` method and do not expose Effect types.
+
+The typed local-node client currently exposes status/shutdown, project
+register/list/show, workspace list/show, explicit repository attachment, and
+durable receipt lookup through keyed `getReceipt` and bounded no-payload
+`listReceipts` (`receipt.list`). The CLI may project a compact page; this
+client stays lossless over the list schema, which already omits `result`.
+It also exposes `probeRuntime`, which uses the same authenticated transport to
+request either the node-owned Codex compatibility probe or the release-disabled
+Pi RPC source candidate. A Pi result is explicitly request-scoped and
+no-model, lists only `set_auto_retry`, `set_auto_compaction`, and `get_state`,
+and remains `releaseQualified: false`; the SDK does not infer installation or
+provider availability from the request.
+`listInstalledHarnesses` is the transport-neutral client for the candidate
+`harness.installed.list` ordinary read: exact empty parameters and the closed
+schema-v1 four-item catalog (`codex`, `grok`, `mistral-vibe`, `pi`) with
+`selected` and `authorized` fixed to `false`. The CLI may project a smaller
+agent-efficient view; this method keeps the full protocol result. It does not
+launch, select, authorize, or probe a harness, and it is not release-qualified
+product behavior.
+
+The W0a neutral execution-selection candidate is exposed losslessly through
+`readExecutionCatalog`, `showWorkspaceExecution`, and
+`configureWorkspaceExecution`. The first two are ordinary reads; configure is
+one revision-fenced, stable-command-ID mutation used by the CLI's separate
+`workspace execution set` and `workspace execution clear` grammar. The SDK
+does not choose or call a provider, launch a process, create an execution
+instance, or turn the fixed `local_provider_unbound` resolution into
+availability. All three operations remain release-disabled source candidates.
+
+The typed local-node client now also exposes `planCodexIntegration`,
+`applyCodexIntegration`, `statusCodexIntegration`, and
+`removeCodexIntegration`. They losslessly validate the strict
+`maia.integration-authorization/v1` results and accept no caller-selected
+executable identity or policy fields. Apply and remove preserve stable command
+IDs and mutation recovery through the Node transport. The SDK grants no process
+authority and performs no filesystem inspection or cleanup itself. The exact
+SDK/authenticated-IPC path is source-qualified at revision
+`80631fb5c9adeb38ab58b12a7db80647161d5871`; all four operations remain
+release-disabled candidates and do not enable a Codex consumer.
+
+The client also implements the lossless release-disabled
+`planPiRpcIntegration`, `applyPiRpcIntegration`, `statusPiRpcIntegration`, and
+`removePiRpcIntegration` source-candidate methods. Their separate schema-v14
+Pi authorization carries exact Node 24.19.0/Pi 0.84.2 interpreter, entry,
+package-closure, session-format, owner-set, and conversation-policy identity
+while accepting no caller path, native file, tool, workspace path, credential,
+or provider field. These transport methods do not grant authority, start a
+runtime, or establish execution-provider availability.
+
+The durable session ledger foundation is source-callable through
+`createSession`, `listSessions`, `showSession`, and `listSessionEvents`.
+`startSession` persists asynchronous activation intent. Runtime `pi` with
+profile `pi-rpc` routes through the active conversation authorization and exact
+native Session binding; Codex still requires its private source authority.
+`sendTurn`, `showTurn`, and `interruptTurn` use the same runtime-discriminated
+family. Pi send/interrupt require active authorization, while durable Pi
+history remains readable after authorization loss. Callers can observe running,
+recovering, failed, interrupted, or completed state through bounded unary
+queries and event cursors. Live attachment remains a later streaming contract.
+These methods grant no tools, credentials/provider, workspace mutation, or
+release enablement.
+
+`status` carries the node-owned compact process-resource health projection
+without giving the SDK process authority. Clients can distinguish healthy,
+admission warning/saturation, and cleanup-unknown fencing; inspect exact
+active/tracked/watcher and permit counts; and render the bounded next-step
+code. The same typed result carries bounded latest-target CPU, RSS/peak RSS,
+process, FD, and I/O availability plus advisory declared-budget warnings. The
+macOS variant remains explicitly cooperative, source-candidate-only,
+not release-qualified, without hard CPU/memory/process enforcement or sampled-
+pressure auto-termination.
+
+The macOS live-terminal source candidate exposes exactly 13 methods: `createTerminal`,
+`listTerminals`, `showTerminal`, `listTerminalEvents`, `readTerminal`,
+controller request/show/acquire/release, `writeTerminalInput`,
+`resizeTerminal`, `signalTerminal`, and `closeTerminal`. It accepts no caller
+executable, argv, environment, or cwd and supervises no process in the SDK.
+Observer attach/check/detach/resync, controller renew, restart, delete, and
+mutation reconcile remain unavailable or inert. These browser-safe unary
+methods are real-boundary proven but remain blocked, release-disabled source
+candidates rather than release-qualified product behavior.
+
+The source-implemented local-v1 orchestration candidate adds
+`createOrchestrationRun`, `listOrchestrationRuns`, `showOrchestrationRun`,
+`listOrchestrationTasks`, `showOrchestrationTask`,
+`showOrchestrationDispatch`,
+`checkOrchestrationInbox`, `acknowledgeOrchestrationDelivery`,
+`openOrchestrationQuestion`, `replyOrchestrationQuestion`,
+`cancelOrchestrationQuestion`, and `settleOrchestrationDispatchTerminal`.
+These are bounded unary methods over the same authenticated transport; the SDK
+supplies no planner, mailbox queue, worker, resident waiter, lifecycle actor,
+database access, process supervision, or caller-selected Message sender. The
+node remains the durable authority and all twelve methods remain
+blocked, release-disabled candidate behavior. `listOrchestrationRuns` is a
+workspace-scoped page of compact Run records. `listOrchestrationTasks` is a
+Run-scoped, objective-free Task index. `showOrchestrationTask` is the keyed
+read of one full Task, including its objective. `showOrchestrationDispatch`
+is the keyed read of the one Run-scoped Dispatch record; it is not a worker
+or preamble projection. The CLI may project a compact aggregate for
+`createOrchestrationRun`, `showOrchestrationRun`, Question mutations, and
+`settleOrchestrationDispatchTerminal`; these SDK methods stay lossless.
+
+The source-implemented `showCurrentContext` query is the single
+transport-neutral SDK operation behind `maia context show --json`. It submits
+exact empty parameters over the authenticated local connection and losslessly
+validates a Client-only projection with `attachmentUsed: false`. IC0 Client
+results omit `nodeId` until ADR-014 NodeBootstrap allocates an authoritative
+value; the SDK remains lossless over that optional-field schema. It never
+accepts a caller-selected principal or Session ID as proof. Inbox
+`--scope current` waits for a mailbox-owning principal. The
+result is a bounded, redacted projection, not a credential or cached
+authorization decision. Session/Run/Dispatch attachments, remote adapters, and
+descendant inheritance remain out of this slice. The method is a blocked,
+release-disabled candidate.
+
+The source also exposes `sendTurn`, `showTurn`, and `interruptTurn` for the
+schema-v6 turn candidate. Those methods are source-implemented SDK candidates,
+not release-qualified or enabled product behavior. `interruptTurn` is a
+runtime-discriminated release-disabled client candidate: the ordinary
+node/SDK/CLI path is callable for an exact active Pi conversation
+authorization, while Codex remains limited to its internal test authority. H2
+and the current G2 record are source-qualified only for revision
+`e7f784b4aa567d19311235d729b047f96c9dfc7c` and its exact bound artifact;
+prior records remain exact-artifact historical evidence. Ordinary Darwin-arm64
+composition verifies the embedded sibling helper but rejects every process
+consumer before native preparation. The exact Codex/Git migrations,
+current-source real-Codex lifecycle, and bounded coding-task proofs now pass
+only for their named revisions. The methods remain blocked with the owning
+node/CLI consumer. A1 still lacks exact npm tarball closure,
+integrity/provenance, carried-helper identity, clean installation, and an
+explicit release decision. The retained macOS F1/H2 manifest remains
+historical exact-artifact evidence; app/DMG qualification belongs to the later
+Desktop/native channel.
+
+`@maiaos/sdk/node` implements the first real adapter. Callers may provide an exact
+ready endpoint and credential path, or call `connectLocalNode` to resolve the
+current profile's private connection descriptor. The adapter then:
+
+- validates transport options and the local-node request/response schemas;
+- requires the credential and Unix socket to be owned by the current user,
+  private, regular/single-linked where applicable, and inside private
+  directories;
+- uses `O_NOFOLLOW | O_NONBLOCK` on Unix, rejects non-regular credentials after
+  opening, and verifies the descriptor against its current path before sending
+  it;
+- applies the protocol's one-MiB frame and 4,096-chunk compatibility limits;
+- independently bounds each transport instance to eight in-flight requests and
+  each complete filesystem/connect/response operation to five seconds;
+- fails fast when saturated and destroys the socket on interruption;
+- returns generic client-facing transport failures without putting paths or
+  credentials in messages.
+- validates a bounded, private, no-follow descriptor against its deterministic
+  profile location and proves its process identity with an authenticated
+  `node.status` call before returning a discovered client.
+
+`connectLocalNode` accepts a standard `AbortSignal`; interruption propagates to
+the authenticated identity probe and closes its real socket.
+
+The Node adapter is deliberately a separate export so browser, Expo, and mobile
+bundles do not import Node filesystem or socket modules:
+
+```ts
+import { createLocalNodeClient } from "@maiaos/sdk";
+import { connectLocalNode, createLocalNodeTransport } from "@maiaos/sdk/node";
+
+const client = createLocalNodeClient(
+  createLocalNodeTransport({
+    credentialPath,
+    endpoint: readyRecord.endpoint,
+  }),
+);
+
+const discovered = await connectLocalNode({ profile: "default" });
+console.log(discovered.status.lifecycle);
+```
+
+The SDK does not start or stop a daemon implicitly, read node storage, or
+supervise runtimes. Runtime probing, session persistence, and terminal
+ownership remain node operations; the SDK never spawns Codex or a terminal
+itself. OS-service discovery, remote HTTP/WSS, live subscriptions, cursor
+helpers beyond the explicit page contracts, and higher-level generated
+commands remain later slices. Local discovery is intentionally read/probe-only: desktop remains
+the lifecycle owner in the current mode.
+
+ADR-015 accepts a later generated Public operation catalog as the complete
+programmatic view of the exact built public node protocol. Named typed methods
+remain the normal SDK surface; bounded reflective access will be:
+
+```ts
+client.operations.list({ limit, after, query }, options);
+client.operations.show({ operationId }, options);
+client.operations.invoke({ operationId, input, commandId }, options);
+```
+
+These methods are planned and not exported today. Their registry will exclude
+CLI presentation, NodeBootstrap, roadmap-only, database, Worker-administration,
+provider-internal, and private service operations. Listing or describing an
+operation never grants it, and `invoke` must preserve the operation's current
+authentication, Capability, Approval, validation, revision, idempotency,
+Receipt, cancellation, cursor, and availability behavior.
+
+The accepted TypeScript Notebook kernel receives a short-lived injected
+`maia` bridge generated from and conformant with this SDK; cell source does not
+import `@maiaos/sdk` or receive a general node credential. External Harnesses may
+use this package directly or the CLI. Protocol, SDK, CLI/help, and injected-
+bridge catalog digests and fixtures must agree. Notebook schemas, methods, and
+the bridge are unimplemented, and cell execution remains blocked until A6/W3
+hard containment and the [Notebook product gates](../../services/README.md#execution--portable-notebooks)
+pass.
+
+The adapter uses Effect v4 for named effects, typed failures, bracketed file
+handles, interruption, the five-second deadline, and fail-fast semaphore
+admission. Native Node filesystem and socket calls remain the narrow boundary
+because the generic platform filesystem does not expose the numeric
+`O_NOFOLLOW` open needed here, and its socket abstraction does not own Windows
+named pipes. XState is intentionally absent from one request/response exchange:
+there is no durable or user-visible lifecycle topology yet. Connection
+supervision, reconnect, and subscription state will introduce the machine when
+those states become real.
+
+Tests cover the transport through real Unix sockets or Windows named pipes and
+also start the exact built `maia-node` and `maia status` executables from the
+node integration suite. The real-filesystem cases include private descriptor
+discovery, descriptor mismatch/symlink/size rejection, a no-writer FIFO,
+deadline-triggered socket cleanup, cancellation, saturation, and
+same-transport permit recovery.
+
+The product sequence and full client expectations are owned by
+[canonical roadmap](../../ROADMAP.md). Internal Maia services use
+explicit typed ports or authenticated versioned service protocols at their own
+boundaries; this product-client SDK is not permission to share private stores.
+In-memory tests remain only for transport-neutral client validation. Node
+24.19.0 is the sole supported runtime; SDK performance claims require retained
+raw evidence from that exact runtime and the documented reference host.
+
+The live-terminal package layout remains labeled predecessor evidence: 23,744
+packed bytes, 126,998 unpacked bytes, and 14 entries. That decision's
+predecessor was 22,647 packed and 116,746 unpacked bytes; the deltas were
++4.843909% and +8.781457%. The current comparison identity is 17,997 packed
+bytes, 85,879 unpacked bytes, and 8 entries. Direct dependencies remain three
+and bundled dependencies remain zero. The published pack now omits declaration
+maps and JavaScript source maps because both point at unpublished `src/` and
+carry no `sourcesContent`; local `dist` still emits them. Types and the public
+export surface stay in the tarball. The standalone CLI keeps its linked map.
+This decision does not qualify the terminal product, F1, or a release. See the
+[current comparison identity](../../services/README.md#benchmarks--sdkcli-collapsed-pack-and-standalone-comparison-identity-approved)
+and the
+[live-terminal predecessor](../../services/README.md#benchmarks--live-terminal-sdkcli-package-footprint-baseline-decision-approved).
+
+A future device-capability-host SDK role will use credentials, grants, and
+transport authority distinct from this product-client surface. It is planned
+and not exported today; see
+[Device capabilities](../../services/README.md#device-capabilities).

package/dist/index.d.ts

@@ -0,0 +1,96 @@
+import { type ExecutionCatalogGetParameters, type ExecutionCatalogGetResult, type InstalledHarnessListParameters, type InstalledHarnessListResult, type IntegrationApplyCodexParameters, type IntegrationApplyCodexResult, type IntegrationApplyPiRpcParameters, type IntegrationApplyPiRpcResult, type IntegrationPlanCodexParameters, type IntegrationPlanCodexResult, type IntegrationPlanPiRpcParameters, type IntegrationPlanPiRpcResult, type IntegrationRemoveCodexParameters, type IntegrationRemoveCodexResult, type IntegrationRemovePiRpcParameters, type IntegrationRemovePiRpcResult, type IntegrationStatusCodexParameters, type IntegrationStatusCodexResult, type IntegrationStatusPiRpcParameters, type IntegrationStatusPiRpcResult, type InvocationContextShowParameters, type InvocationContextShowResult, type LiveTerminalCloseParameters, type LiveTerminalCloseResult, type LiveTerminalControllerAcquireParameters, type LiveTerminalControllerAcquireResult, type LiveTerminalControllerReleaseParameters, type LiveTerminalControllerReleaseResult, type LiveTerminalControllerRequestParameters, type LiveTerminalControllerRequestResult, type LiveTerminalControllerRequestShowParameters, type LiveTerminalControllerRequestShowResult, type LiveTerminalResizeParameters, type LiveTerminalResizeResult, type LiveTerminalSignalParameters, type LiveTerminalSignalResult, type LiveTerminalWriteParameters, type LiveTerminalWriteResult, type LocalNodeOperationErrorCode, type LocalNodeShutdownResult, type LocalNodeStatusResult, type MonitorBootstrapCreateResult, type OrchestrationDispatchSettleTerminalParameters, type OrchestrationDispatchSettleTerminalResult, type OrchestrationDispatchShowParameters, type OrchestrationDispatchShowResult, type OrchestrationInboxAckParameters, type OrchestrationInboxAckResult, type OrchestrationInboxCheckParameters, type OrchestrationInboxCheckResult, type OrchestrationQuestionCancelParameters, type OrchestrationQuestionCancelResult, type OrchestrationQuestionOpenParameters, type OrchestrationQuestionOpenResult, type OrchestrationQuestionReplyParameters, type OrchestrationQuestionReplyResult, type OrchestrationRunCreateParameters, type OrchestrationRunCreateResult, type OrchestrationRunListParameters, type OrchestrationRunListResult, type OrchestrationRunShowParameters, type OrchestrationRunShowResult, type OrchestrationTaskListParameters, type OrchestrationTaskListResult, type OrchestrationTaskShowParameters, type OrchestrationTaskShowResult, type ProjectListParameters, type ProjectListResult, type ProjectRegisterParameters, type ProjectRegisterResult, type ProjectShowParameters, type ProjectShowResult, type ProtocolError, type ProtocolRequestEnvelope, type ReceiptGetParameters, type ReceiptGetResult, type ReceiptListParameters, type ReceiptListResult, type RuntimeParser, type RuntimeProbeParameters, type RuntimeProbeResult, type SessionCreateParameters, type SessionCreateResult, type SessionEventsListParameters, type SessionEventsListResult, type SessionListParameters, type SessionListResult, type SessionShowParameters, type SessionShowResult, type SessionStartParameters, type SessionStartResult, type TerminalCreateParameters, type TerminalCreateResult, type TerminalEventsListParameters, type TerminalEventsListResult, type TerminalListParameters, type TerminalListResult, type TerminalReadParameters, type TerminalReadResult, type TerminalShowParameters, type TerminalShowResult, type TurnInterruptParameters, type TurnInterruptResult, type TurnSendParameters, type TurnSendResult, type TurnShowParameters, type TurnShowResult, type WorkspaceExecutionConfigureParameters, type WorkspaceExecutionConfigureResult, type WorkspaceExecutionShowParameters, type WorkspaceExecutionShowResult, type WorkspaceListParameters, type WorkspaceListResult, type WorkspaceRepositoryAttachParameters, type WorkspaceRepositoryAttachResult, type WorkspaceShowParameters, type WorkspaceShowResult } from "@maiaos/protocol";
+export type { CapabilityDescriptor, ExecutionCatalogGetParameters, ExecutionCatalogGetResult, ExecutionProfile, ExecutionProviderDescriptor, InstalledHarnessListParameters, InstalledHarnessListResult, IntegrationApplyCodexParameters, IntegrationApplyCodexResult, IntegrationApplyPiRpcParameters, IntegrationApplyPiRpcResult, IntegrationAuthorization, IntegrationAuthorizationStatusItem, IntegrationPlanCodexParameters, IntegrationPlanCodexResult, IntegrationPlanPiRpcParameters, IntegrationPlanPiRpcResult, IntegrationRemoveCodexParameters, IntegrationRemoveCodexResult, IntegrationRemovePiRpcParameters, IntegrationRemovePiRpcResult, IntegrationStatusCodexParameters, IntegrationStatusCodexResult, IntegrationStatusPiRpcParameters, IntegrationStatusPiRpcResult, InvocationContextShowParameters, InvocationContextShowResult, LiveTerminalCloseParameters, LiveTerminalCloseResult, LiveTerminalControllerAcquireParameters, LiveTerminalControllerAcquireResult, LiveTerminalControllerLease, LiveTerminalControllerReleaseParameters, LiveTerminalControllerReleaseResult, LiveTerminalControllerRequest, LiveTerminalControllerRequestParameters, LiveTerminalControllerRequestResult, LiveTerminalControllerRequestShowParameters, LiveTerminalControllerRequestShowResult, LiveTerminalCreateParameters, LiveTerminalCreateResult, LiveTerminalMutationOutcomeUnknown, LiveTerminalMutationReceipt, LiveTerminalResizeParameters, LiveTerminalResizeResult, LiveTerminalSession, LiveTerminalSignalParameters, LiveTerminalSignalResult, LiveTerminalWriteParameters, LiveTerminalWriteResult, LocalNodeEndpoint, LocalNodeOperationErrorCode, LocalNodeShutdownResult, LocalNodeStatusResult, MonitorBootstrapCreateResult, OrchestrationAggregate, OrchestrationAttempt, OrchestrationDelivery, OrchestrationDispatch, OrchestrationDispatchSettleTerminalParameters, OrchestrationDispatchSettleTerminalResult, OrchestrationDispatchShowParameters, OrchestrationDispatchShowResult, OrchestrationInboxAckParameters, OrchestrationInboxAckResult, OrchestrationInboxCheckParameters, OrchestrationInboxCheckResult, OrchestrationMailbox, OrchestrationMessage, OrchestrationQuestion, OrchestrationQuestionCancelParameters, OrchestrationQuestionCancelResult, OrchestrationQuestionOpenParameters, OrchestrationQuestionOpenResult, OrchestrationQuestionReplyParameters, OrchestrationQuestionReplyResult, OrchestrationRun, OrchestrationRunCreateParameters, OrchestrationRunCreateResult, OrchestrationRunListParameters, OrchestrationRunListResult, OrchestrationRunShowParameters, OrchestrationRunShowResult, OrchestrationTask, OrchestrationTaskGraph, OrchestrationTaskInput, OrchestrationTaskListParameters, OrchestrationTaskListResult, OrchestrationTaskShowParameters, OrchestrationTaskShowResult, OrchestrationTaskSummary, Project, ProjectListParameters, ProjectListResult, ProjectRegisterParameters, ProjectRegisterResult, ProjectShowParameters, ProjectShowResult, ProtocolEnvelope, ProtocolError, ProtocolIdentifier, ProtocolMessageKind, ProtocolRequestEnvelope, ProtocolVersion, ReceiptGetParameters, ReceiptGetResult, ReceiptListCursor, ReceiptListItem, ReceiptListParameters, ReceiptListResult, Repository, RuntimeProbeParameters, RuntimeProbeResult, Session, SessionCreateParameters, SessionCreateResult, SessionEvent, SessionEventsListParameters, SessionEventsListResult, SessionListParameters, SessionListResult, SessionShowParameters, SessionShowResult, SessionStartParameters, SessionStartResult, Terminal, TerminalChunk, TerminalCreateParameters, TerminalCreateResult, TerminalEvent, TerminalEventsListParameters, TerminalEventsListResult, TerminalListParameters, TerminalListResult, TerminalReadParameters, TerminalReadResult, TerminalShowParameters, TerminalShowResult, Turn, TurnInput, TurnInterruptParameters, TurnInterruptResult, TurnSendParameters, TurnSendResult, TurnShowParameters, TurnShowResult, TurnTokenUsage, Workspace, WorkspaceCheckout, WorkspaceExecutionBinding, WorkspaceExecutionConfigureParameters, WorkspaceExecutionConfigureResult, WorkspaceExecutionResolution, WorkspaceExecutionSelection, WorkspaceExecutionShowParameters, WorkspaceExecutionShowResult, WorkspaceListParameters, WorkspaceListResult, WorkspaceRepositoryAttachParameters, WorkspaceRepositoryAttachResult, WorkspaceShowParameters, WorkspaceShowResult, } from "@maiaos/protocol";
+export { capabilityDescriptorSchema, capabilityListSchema, capabilityNameSchema, createProtocolEnvelopeSchema, createRequestEnvelopeSchema, createRuntimeSchema, createSuccessEnvelopeSchema, DEFAULT_ORCHESTRATION_CHECK_PAGE_SIZE, DEFAULT_ORCHESTRATION_LIST_PAGE_SIZE, DEFAULT_ORCHESTRATION_TASK_LIST_PAGE_SIZE, DEFAULT_RECEIPT_LIST_PAGE_SIZE, EXECUTION_SCHEMA_VERSION, executionCatalogGetParametersSchema, executionCatalogGetResultSchema, executionProfileSchema, executionProviderDescriptorSchema, inspectOrchestrationRunCreateAdmission, installedHarnessListParametersSchema, installedHarnessListResultSchema, integrationApplyCodexParametersSchema, integrationApplyCodexResultSchema, integrationApplyPiRpcParametersSchema, integrationApplyPiRpcResultSchema, integrationAuthorizationSchema, integrationAuthorizationStatusItemSchema, integrationPlanCodexParametersSchema, integrationPlanCodexResultSchema, integrationPlanPiRpcParametersSchema, integrationPlanPiRpcResultSchema, integrationRemoveCodexParametersSchema, integrationRemoveCodexResultSchema, integrationRemovePiRpcParametersSchema, integrationRemovePiRpcResultSchema, integrationStatusCodexParametersSchema, integrationStatusCodexResultSchema, integrationStatusPiRpcParametersSchema, integrationStatusPiRpcResultSchema, INVOCATION_CONTEXT_ACTOR_LOCAL_USER, INVOCATION_CONTEXT_ALLOWED_ACTION_SHOW, INVOCATION_CONTEXT_CLIENT_PRINCIPAL_ID, INVOCATION_CONTEXT_ERROR_NODE_UNAVAILABLE, INVOCATION_CONTEXT_ERROR_OVERRIDE_FORBIDDEN, INVOCATION_CONTEXT_SCHEMA_VERSION, invocationContextShowParametersSchema, invocationContextShowResultSchema, liveTerminalCloseParametersSchema, liveTerminalCloseResultSchema, liveTerminalControllerAcquireParametersSchema, liveTerminalControllerAcquireResultSchema, liveTerminalControllerReleaseParametersSchema, liveTerminalControllerReleaseResultSchema, liveTerminalControllerRequestParametersSchema, liveTerminalControllerRequestResultSchema, liveTerminalControllerRequestShowParametersSchema, liveTerminalControllerRequestShowResultSchema, liveTerminalCreateParametersSchema, liveTerminalCreateResultSchema, liveTerminalResizeParametersSchema, liveTerminalResizeResultSchema, liveTerminalSignalParametersSchema, liveTerminalSignalResultSchema, liveTerminalWriteParametersSchema, liveTerminalWriteResultSchema, LOCAL_DEFAULT_POLICY_ID, LOCAL_HOST_PROFILE_ID, LOCAL_HOST_PROVIDER_ID, localNodeEndpointSchema, localNodeOperationErrorCodeSchema, localNodeRequestPayloadSchema, localNodeShutdownResultSchema, localNodeStatusResultSchema, MAIA_PROTOCOL_VERSION, MAX_ORCHESTRATION_CHECK_PAGE_SIZE, MAX_ORCHESTRATION_LIST_PAGE_SIZE, MAX_ORCHESTRATION_TASK_LIST_PAGE_SIZE, MAX_RECEIPT_LIST_PAGE_SIZE, MAX_RECEIPT_LIST_RESULT_BYTES, MAX_TERMINAL_COLUMNS, MAX_TERMINAL_CONTROLLER_LEASE_MS, MAX_TERMINAL_GENERATION, MAX_TERMINAL_INPUT_CHUNK_BYTES, MAX_TERMINAL_INPUT_SEQUENCE, MAX_TERMINAL_ROWS, MAX_TURN_INPUT_BYTES, MIN_TERMINAL_COLUMNS, MIN_TERMINAL_CONTROLLER_LEASE_MS, MIN_TERMINAL_ROWS, monitorBootstrapCreateResultSchema, orchestrationDispatchSettleTerminalParametersSchema, orchestrationDispatchSettleTerminalResultSchema, orchestrationDispatchShowParametersSchema, orchestrationDispatchShowResultSchema, orchestrationInboxAckParametersSchema, orchestrationInboxAckResultSchema, orchestrationInboxCheckParametersSchema, orchestrationInboxCheckResultSchema, orchestrationQuestionCancelParametersSchema, orchestrationQuestionCancelResultSchema, orchestrationQuestionOpenParametersSchema, orchestrationQuestionOpenResultSchema, orchestrationQuestionReplyParametersSchema, orchestrationQuestionReplyResultSchema, orchestrationRunCreateParametersSchema, orchestrationRunCreateResultSchema, orchestrationRunListParametersSchema, orchestrationRunListResultSchema, orchestrationRunShowParametersSchema, orchestrationRunShowResultSchema, orchestrationTaskGraphSchema, orchestrationTaskListParametersSchema, orchestrationTaskListResultSchema, orchestrationTaskShowParametersSchema, orchestrationTaskShowResultSchema, orchestrationTaskSummarySchema, placementPolicySchema, projectListParametersSchema, projectListResultSchema, projectRegisterParametersSchema, projectRegisterResultSchema, projectSchema, projectShowParametersSchema, projectShowResultSchema, protocolErrorCodeSchema, protocolErrorEnvelopeSchema, protocolErrorSchema, protocolIdentifierSchema, protocolMessageKindSchema, protocolRequestEnvelopeSchema, protocolSuccessEnvelopeSchema, protocolVersionSchema, receiptGetParametersSchema, receiptListCursorSchema, receiptListItemSchema, receiptListParametersSchema, receiptListResultSchema, repositorySchema, runtimeProbeParametersSchema, runtimeProbeResultSchema, sessionCreateParametersSchema, sessionCreateResultSchema, sessionEventSchema, sessionEventsListParametersSchema, sessionEventsListResultSchema, sessionListParametersSchema, sessionListResultSchema, sessionSchema, sessionShowParametersSchema, sessionShowResultSchema, sessionStartParametersSchema, sessionStartResultSchema, terminalChunkSchema, terminalCreateParametersSchema, terminalCreateResultSchema, terminalEventSchema, terminalEventsListParametersSchema, terminalEventsListResultSchema, terminalListParametersSchema, terminalListResultSchema, terminalReadParametersSchema, terminalReadResultSchema, terminalSchema, terminalShowParametersSchema, terminalShowResultSchema, turnInputSchema, turnInterruptParametersSchema, turnInterruptResultSchema, turnSchema, turnSendParametersSchema, turnSendResultSchema, turnShowParametersSchema, turnShowResultSchema, turnTokenUsageSchema, workspaceCheckoutSchema, workspaceExecutionBindingSchema, workspaceExecutionConfigureParametersSchema, workspaceExecutionConfigureResultSchema, workspaceExecutionResolutionSchema, workspaceExecutionSelectionSchema, workspaceExecutionShowParametersSchema, workspaceExecutionShowResultSchema, workspaceListParametersSchema, workspaceListResultSchema, workspaceRepositoryAttachParametersSchema, workspaceRepositoryAttachResultSchema, workspaceSchema, workspaceShowParametersSchema, workspaceShowResultSchema, } from "@maiaos/protocol";
+export type CancellationSignal = AbortSignal;
+export type TransportRequestOptions = {
+    readonly signal?: CancellationSignal;
+};
+export type MaiaTransport = {
+    readonly request: (envelope: ProtocolRequestEnvelope<unknown>, options?: TransportRequestOptions) => Promise<unknown>;
+};
+export type RuntimeSchema<TValue> = RuntimeParser<TValue>;
+export type MaiaRequest<TInput, TOutput> = {
+    readonly inputSchema: RuntimeSchema<TInput>;
+    readonly messageId: string;
+    readonly outputSchema: RuntimeSchema<TOutput>;
+    readonly payload: TInput;
+    readonly signal?: CancellationSignal;
+};
+export type MaiaClientErrorCode = "cancelled" | "correlation_mismatch" | "invalid_request" | "invalid_response" | "remote_error" | "transport_failure" | LocalNodeOperationErrorCode;
+export declare class MaiaClientError extends Error {
+    readonly code: MaiaClientErrorCode;
+    readonly remoteError?: ProtocolError;
+    constructor(code: MaiaClientErrorCode, message: string, options?: ErrorOptions & {
+        readonly remoteError?: ProtocolError;
+    });
+}
+export type MaiaClient = {
+    readonly request: <TInput, TOutput>(request: MaiaRequest<TInput, TOutput>) => Promise<TOutput>;
+};
+export type LocalNodeRequestOptions = {
+    readonly messageId: string;
+    readonly signal?: CancellationSignal;
+};
+export type LocalNodeClient = {
+    readonly acknowledgeOrchestrationDelivery: (parameters: OrchestrationInboxAckParameters, options: LocalNodeRequestOptions) => Promise<OrchestrationInboxAckResult>;
+    readonly acquireTerminalController: (parameters: LiveTerminalControllerAcquireParameters, options: LocalNodeRequestOptions) => Promise<LiveTerminalControllerAcquireResult>;
+    readonly applyCodexIntegration: (parameters: IntegrationApplyCodexParameters, options: LocalNodeRequestOptions) => Promise<IntegrationApplyCodexResult>;
+    readonly applyPiRpcIntegration: (parameters: IntegrationApplyPiRpcParameters, options: LocalNodeRequestOptions) => Promise<IntegrationApplyPiRpcResult>;
+    readonly attachWorkspaceRepository: (parameters: WorkspaceRepositoryAttachParameters, options: LocalNodeRequestOptions) => Promise<WorkspaceRepositoryAttachResult>;
+    readonly cancelOrchestrationQuestion: (parameters: OrchestrationQuestionCancelParameters, options: LocalNodeRequestOptions) => Promise<OrchestrationQuestionCancelResult>;
+    readonly checkOrchestrationInbox: (parameters: OrchestrationInboxCheckParameters, options: LocalNodeRequestOptions) => Promise<OrchestrationInboxCheckResult>;
+    readonly closeTerminal: (parameters: LiveTerminalCloseParameters, options: LocalNodeRequestOptions) => Promise<LiveTerminalCloseResult>;
+    readonly configureWorkspaceExecution: (parameters: WorkspaceExecutionConfigureParameters, options: LocalNodeRequestOptions) => Promise<WorkspaceExecutionConfigureResult>;
+    readonly createMonitorBootstrap: (options: LocalNodeRequestOptions) => Promise<MonitorBootstrapCreateResult>;
+    readonly createOrchestrationRun: (parameters: OrchestrationRunCreateParameters, options: LocalNodeRequestOptions) => Promise<OrchestrationRunCreateResult>;
+    readonly createSession: (parameters: SessionCreateParameters, options: LocalNodeRequestOptions) => Promise<SessionCreateResult>;
+    readonly createTerminal: (parameters: TerminalCreateParameters, options: LocalNodeRequestOptions) => Promise<TerminalCreateResult>;
+    readonly getReceipt: (parameters: ReceiptGetParameters, options: LocalNodeRequestOptions) => Promise<ReceiptGetResult>;
+    readonly interruptTurn: (parameters: TurnInterruptParameters, options: LocalNodeRequestOptions) => Promise<TurnInterruptResult>;
+    readonly listInstalledHarnesses: (parameters: InstalledHarnessListParameters, options: LocalNodeRequestOptions) => Promise<InstalledHarnessListResult>;
+    readonly listOrchestrationRuns: (parameters: OrchestrationRunListParameters, options: LocalNodeRequestOptions) => Promise<OrchestrationRunListResult>;
+    readonly listOrchestrationTasks: (parameters: OrchestrationTaskListParameters, options: LocalNodeRequestOptions) => Promise<OrchestrationTaskListResult>;
+    readonly listProjects: (parameters: ProjectListParameters, options: LocalNodeRequestOptions) => Promise<ProjectListResult>;
+    readonly listReceipts: (parameters: ReceiptListParameters, options: LocalNodeRequestOptions) => Promise<ReceiptListResult>;
+    readonly listSessionEvents: (parameters: SessionEventsListParameters, options: LocalNodeRequestOptions) => Promise<SessionEventsListResult>;
+    readonly listSessions: (parameters: SessionListParameters, options: LocalNodeRequestOptions) => Promise<SessionListResult>;
+    readonly listTerminalEvents: (parameters: TerminalEventsListParameters, options: LocalNodeRequestOptions) => Promise<TerminalEventsListResult>;
+    readonly listTerminals: (parameters: TerminalListParameters, options: LocalNodeRequestOptions) => Promise<TerminalListResult>;
+    readonly listWorkspaces: (parameters: WorkspaceListParameters, options: LocalNodeRequestOptions) => Promise<WorkspaceListResult>;
+    readonly openOrchestrationQuestion: (parameters: OrchestrationQuestionOpenParameters, options: LocalNodeRequestOptions) => Promise<OrchestrationQuestionOpenResult>;
+    readonly planCodexIntegration: (parameters: IntegrationPlanCodexParameters, options: LocalNodeRequestOptions) => Promise<IntegrationPlanCodexResult>;
+    readonly planPiRpcIntegration: (parameters: IntegrationPlanPiRpcParameters, options: LocalNodeRequestOptions) => Promise<IntegrationPlanPiRpcResult>;
+    readonly probeRuntime: (parameters: RuntimeProbeParameters, options: LocalNodeRequestOptions) => Promise<RuntimeProbeResult>;
+    readonly readExecutionCatalog: (parameters: ExecutionCatalogGetParameters, options: LocalNodeRequestOptions) => Promise<ExecutionCatalogGetResult>;
+    readonly readTerminal: (parameters: TerminalReadParameters, options: LocalNodeRequestOptions) => Promise<TerminalReadResult>;
+    readonly registerProject: (parameters: ProjectRegisterParameters, options: LocalNodeRequestOptions) => Promise<ProjectRegisterResult>;
+    readonly releaseTerminalController: (parameters: LiveTerminalControllerReleaseParameters, options: LocalNodeRequestOptions) => Promise<LiveTerminalControllerReleaseResult>;
+    readonly removeCodexIntegration: (parameters: IntegrationRemoveCodexParameters, options: LocalNodeRequestOptions) => Promise<IntegrationRemoveCodexResult>;
+    readonly removePiRpcIntegration: (parameters: IntegrationRemovePiRpcParameters, options: LocalNodeRequestOptions) => Promise<IntegrationRemovePiRpcResult>;
+    readonly replyOrchestrationQuestion: (parameters: OrchestrationQuestionReplyParameters, options: LocalNodeRequestOptions) => Promise<OrchestrationQuestionReplyResult>;
+    readonly requestTerminalController: (parameters: LiveTerminalControllerRequestParameters, options: LocalNodeRequestOptions) => Promise<LiveTerminalControllerRequestResult>;
+    readonly resizeTerminal: (parameters: LiveTerminalResizeParameters, options: LocalNodeRequestOptions) => Promise<LiveTerminalResizeResult>;
+    readonly sendTurn: (parameters: TurnSendParameters, options: LocalNodeRequestOptions) => Promise<TurnSendResult>;
+    readonly settleOrchestrationDispatchTerminal: (parameters: OrchestrationDispatchSettleTerminalParameters, options: LocalNodeRequestOptions) => Promise<OrchestrationDispatchSettleTerminalResult>;
+    readonly showCurrentContext: (parameters: InvocationContextShowParameters, options: LocalNodeRequestOptions) => Promise<InvocationContextShowResult>;
+    readonly showOrchestrationDispatch: (parameters: OrchestrationDispatchShowParameters, options: LocalNodeRequestOptions) => Promise<OrchestrationDispatchShowResult>;
+    readonly showOrchestrationRun: (parameters: OrchestrationRunShowParameters, options: LocalNodeRequestOptions) => Promise<OrchestrationRunShowResult>;
+    readonly showOrchestrationTask: (parameters: OrchestrationTaskShowParameters, options: LocalNodeRequestOptions) => Promise<OrchestrationTaskShowResult>;
+    readonly showProject: (parameters: ProjectShowParameters, options: LocalNodeRequestOptions) => Promise<ProjectShowResult>;
+    readonly showSession: (parameters: SessionShowParameters, options: LocalNodeRequestOptions) => Promise<SessionShowResult>;
+    readonly showTerminal: (parameters: TerminalShowParameters, options: LocalNodeRequestOptions) => Promise<TerminalShowResult>;
+    readonly showTerminalControllerRequest: (parameters: LiveTerminalControllerRequestShowParameters, options: LocalNodeRequestOptions) => Promise<LiveTerminalControllerRequestShowResult>;
+    readonly showTurn: (parameters: TurnShowParameters, options: LocalNodeRequestOptions) => Promise<TurnShowResult>;
+    readonly showWorkspace: (parameters: WorkspaceShowParameters, options: LocalNodeRequestOptions) => Promise<WorkspaceShowResult>;
+    readonly showWorkspaceExecution: (parameters: WorkspaceExecutionShowParameters, options: LocalNodeRequestOptions) => Promise<WorkspaceExecutionShowResult>;
+    readonly shutdown: (options: LocalNodeRequestOptions) => Promise<LocalNodeShutdownResult>;
+    readonly signalTerminal: (parameters: LiveTerminalSignalParameters, options: LocalNodeRequestOptions) => Promise<LiveTerminalSignalResult>;
+    readonly startSession: (parameters: SessionStartParameters, options: LocalNodeRequestOptions) => Promise<SessionStartResult>;
+    readonly status: (options: LocalNodeRequestOptions) => Promise<LocalNodeStatusResult>;
+    readonly statusCodexIntegration: (parameters: IntegrationStatusCodexParameters, options: LocalNodeRequestOptions) => Promise<IntegrationStatusCodexResult>;
+    readonly statusPiRpcIntegration: (parameters: IntegrationStatusPiRpcParameters, options: LocalNodeRequestOptions) => Promise<IntegrationStatusPiRpcResult>;
+    readonly writeTerminalInput: (parameters: LiveTerminalWriteParameters, options: LocalNodeRequestOptions) => Promise<LiveTerminalWriteResult>;
+};
+export declare const createMaiaClient: (transport: MaiaTransport) => MaiaClient;
+export declare const createLocalNodeClient: (transport: MaiaTransport) => LocalNodeClient;
+//# sourceMappingURL=index.d.ts.map