Distillation

🔴 (19:22) /home/byk/Code/opencode-v2-pilot/packages/plugin/src/promise/adapter.ts is 639 lines and adapts a Promise plugin into the existing Effect-only Core plugin runtime through fromPromise(plugin: Plugin). 🔴 (19:22) adapter.ts defines CompiledEndpoint, cached by endpoint object in compiledEndpoints: WeakMap<object, CompiledEndpoint>; compiled data consists of input decoders, an output encoder, and a noContent flag. 🔴 (19:22) compileEndpoint(...) rejects more than one payload schema or success schema with Unsupported API schema cardinality: ${endpoint.identifier}; it decodes params, query, headers, and payload, treats absent success schemas as HttpApiSchema.NoContent, and unwraps a sole data property from object success schemas before encoding. 🔴 (19:22) makeStreams() converts Effect streams into abortable AsyncIterables, gives each iterator its own cleanup closure, removes abort listeners on close, closes iterators on completion or error, and installs a plugin-scope finalizer that closes every active subscription. 🔴 (19:22) rpcFromEffect(...) builds Promise RPC clients from portable definitions, supports method calls with optional abort signals, exposes events.subscribe and events.on, and logs asynchronous event-handler failures through Effect.logError(error). 🔴 (19:22) Promise RPC registration converts handler-thrown or handler-returned ReturnedRpcError instances into host errors through context.error(type, message, data); registrations expose dispose() and events.emit(...). 🔴 (19:22) fromPromise(...) dynamically imports ClientApi from @opencode/protocol/client and OpenCodeEvent from @opencode/protocol/groups/event, then resolves endpoint groups for agent, command, experimental, generate, integration, MCP, model, plugin, permission, provider, reference, Session, skill, VCS, web search, and worktree APIs. 🔴 (19:22) Promise-plugin hook registrations run in the plugin scope through Effect.runPromiseWith(context) and return a Promise-side { dispose() }; plugin unload runs the optional cleanup returned by plugin.setup(context2) through Effect.acquireRelease(...). 🔴 (19:22) adaptApiMethod(...) compiles the endpoint schema, decodes the same optional input against every endpoint input schema, merges decoded objects with Object.assign({}, ...decoded), invokes the Effect host method, returns undefined for no-content endpoints, and otherwise schema-encodes the result. 🔴 (19:22) Promise tool adaptation wraps progress callbacks into Effect execution. Existing tools returned by editor.list() or editor.get(id) receive promiseExecutor(...); tools added or updated execute through executePromiseTool(...). 🔴 (19:22) adapter.ts exposes Promise-context domains app, location, options, agent, aisdk, catalog, command, event, experimental.terminal, generate, integration, mcp, permission, plugin, reference, rpc, skill, storage, tool, vcs, websearch, worktree, session, and shell. 🔴 (19:22) The Promise Session adapter exposes hook, create, get, switchAgent, switchModel, prompt, generate, command, synthetic, interrupt, rename, move, wait, and context, each API operation adapted against its corresponding SessionEndpoints schema. 🔴 (19:22) The Promise integration adapter exposes list/get, key connection, OAuth connect/status/complete/cancel, command connect/status/cancel, transforms, reload, and connection active/resolve; transformed authorization callbacks distinguish "auto" callbacks from code-taking callbacks and optionally adapt credential refresh. 🔴 (19:22) VCS and web-search Promise transforms use attempt(...) to pass an AbortSignal into Promise definitions. VCS definitions adapt info, optional bound base, branches, status, and diff; web-search definitions adapt execute. 🔴 (19:22) Worktree Promise transforms adapt strategy create(input, { signal }), remove(input, { signal }), and list(directory, { signal }). 🔴 (19:22) Promise permission.assert(input) runs host.permission.assert(input) and turns its typed error into a defect carrying new TypedFailure(error). 🔴 (19:22) executePromiseTool(...) converts a caught TypedFailure into Tool.Error; its model-facing message preference is error.error.feedback when that is a string, otherwise error.error.message for an Error, otherwise String(error.error). Other Promise-tool errors become defects through Effect.die(error). 🔴 (19:23) /home/byk/Code/opencode-v2-pilot/packages/core/src/session/model-request.ts defines ExecuteError = Tool.Error | Permission.DeclinedError | QuestionTool.CancelledError. 🔴 (19:23) User directive: A user’s permission decline or question cancellation must “never become model-facing tool output.” 🔴 (19:23) model-request.ts deliberately tunnels Permission.DeclinedError and QuestionTool.CancelledError beneath leaf-level blanket mapError handling as defects, then resurfaces them exactly once as typed failures at the runner execution seam. 🔴 (19:23) declineDefect(cause) inspects cause.reasons, selects the first die reason whose defect is either Permission.DeclinedError or QuestionTool.CancelledError, returns Result.succeed(decline) when found, and otherwise returns Result.fail(cause). 🔴 (19:24) Prepared.executeTool(...) returns Effect.Effect<Tool.NormalizedResult, ExecuteError>; its implementation calls tools.execute({ ...input, definitions: hooked }) and applies Effect.catchCauseFilter(declineDefect, (decline) => Effect.fail(decline)). 🔴 (19:23) model-request.ts sets IMAGE_BYTES_TRIGGER = 25 * 1024 * 1024 (25 MiB), IMAGE_BYTES_TARGET = 15 * 1024 * 1024 (15 MiB), and replacement text "[This image was removed to reduce the request size and is no longer visible. Do not make claims about its contents from memory. If needed, retrieve it again with an available tool or ask the user to attach it again.]". 🔴 (19:23) unsupportedMedia(...) maps MIME prefixes to image, audio, or video, maps application/pdf to pdf, and substitutes unsupported media with ERROR: Cannot read ${name ? \"${name}"` : modality} (this model does not support ${modality} input). Inform the user.; unsupportedParts(...)applies this both to direct media and file content inside tool results. 🔴 (19:24) Model-request WebSocket use requires all of: model capabilityresponsesWebsockets === true, provider-specific config flag ``OPENCODE_EXPERIMENTAL_${providerID.replace(/[^a-zA-Z0-9]+/g, "_").toUpperCase()}_RESPONSES_WEBSOCKET``, input.webSocket === "session", and no Session HTTP hooks; otherwise no Session WebSocket is bound. 🔴 (19:24) /home/byk/Code/opencode-v2-pilot/packages/plugin/src/effect/permission.tsis 36 lines.PermissionDomainextendsPick<PermissionApi<unknown>, "list" | "get" | "reply">withassert(input): Effect.Effect<void, unknown>andhook: Hooks<PermissionHooks>. 🔴 (19:24) /home/byk/Code/opencode-v2-pilot/packages/plugin/src/promise/permission.tsis 35 lines. Its parallelPermissionDomainextendsPick<PermissionApi, "list" | "get" | "reply">withassert(input): Promise<void>andhook: Hooks<PermissionHooks>. 🔴 (19:24) Both Effect and Promise permission APIs define PermissionEvaluationwithsessionID, optional agent, action, resources, optional metadata, optional source, mutable effect: Permission.Effect, and optional mutable message. 🔴 (19:24) Both Effect and Promise permission APIs define PermissionAssertInputwithsessionID, action, resources, optional save, optional metadata, optional source, and optional agent`.