@tbrandenburg/opencode-a2a-lite 0.4.1 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -89,6 +89,7 @@ launcher still use Linux-specific tooling.
89
89
 
90
90
  ```text
91
91
  opencode-a2a-lite --workspace <path> [--port <0..65535>] [--publish-activity]
92
+ [--permissions <reject|ask>]
92
93
  opencode-a2a-lite --help | --version
93
94
  ```
94
95
 
@@ -134,10 +135,21 @@ reusing the ACP session for that context.
134
135
  commands or workspace data, so enable it only for clients you trust. The Agent Card then
135
136
  declares the `urn:opencode-a2a-lite:activity:v1` extension. Reasoning appears only for models
136
137
  and effort settings that emit it (for example Claude Haiku 5.5 with `effort=high`).
137
- - The gateway never approves permission requests. A turn stopped by a rejection ends `canceled`
138
- with the message "Permission request rejected" and `opencode.permissionDenied: "true"` in the
139
- task metadata; a client cancellation carries neither. Permissions that OpenCode's own configuration
140
- allows are never asked, so they are never rejected.
138
+ - By default the gateway rejects every permission request. A turn stopped by a rejection ends
139
+ `canceled` with the message "Permission request rejected" and `opencode.permissionDenied: "true"`
140
+ in the task metadata; a client cancellation carries neither. Permissions that OpenCode's own
141
+ configuration allows are never asked, so they are never rejected.
142
+ - `--permissions ask` lets a client decide. The task pauses as `input-required` with a text
143
+ question and a data part `{"permission": {requestId, title, kind, options}}`; metadata shows
144
+ `opencode.permissionPending: "true"` and the request id. Answer on the **same task**
145
+ (`a2a send -a <url> --task-id <id> --context-id <ctx> allow`, or `reject`, or a data part
146
+ `{"permissionResponse": {"requestId", "optionId"}}`). A wrong id or option leaves the request
147
+ open; only `allow_once` and the reject options are offered, never `allow_always`. No answer
148
+ within 120 seconds rejects once. While waiting, the single prompt slot stays held (other tasks
149
+ get "busy") and the prompt deadline is suspended; canceling the task cancels the request without
150
+ marking a denial. **Anyone who can reach the unauthenticated port can approve tool runs in this
151
+ mode**, so keep it on loopback and for trusted clients only. The Agent Card declares the
152
+ `urn:opencode-a2a-lite:permissions:v1` extension.
141
153
  - Defaults: 30-second startup/session allocation, 120-second prompt, 5-second
142
154
  cancellation and 5-second ACP shutdown. Failure retires the unhealthy bridge.
143
155
  - Streaming sends stable artifact IDs and ordered append events. Task states are
package/dist/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tbrandenburg/opencode-a2a-lite",
3
- "version": "0.4.1",
3
+ "version": "0.5.0",
4
4
  "description": "OpenCode ACP to A2A gateway for trusted workspaces",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -5,6 +5,7 @@ import * as acp from "@agentclientprotocol/sdk";
5
5
  import manifest from "../package.json" with { type: "json" };
6
6
  import { activityOf } from "./activity.js";
7
7
  import { BridgeError } from "./bridge-error.js";
8
+ import { askOperator, decide } from "./permission.js";
8
9
  import { supportedOpenCode } from "./opencode-version.js";
9
10
  import { StartupError } from "./startup-error.js";
10
11
  export function createAcpBridge(options) {
@@ -40,11 +41,24 @@ export function createAcpBridge(options) {
40
41
  // Retain the cleanup result for close(); request errors never contain peer diagnostics.
41
42
  void close().catch(() => undefined);
42
43
  }
43
- function bounded(operation, ms, label) {
44
+ // While a human decision is pending (hold.count > 0) the deadline is suspended and restarts on release.
45
+ function bounded(operation, ms, label, hold) {
44
46
  if (failure.signal.aborted)
45
47
  return Promise.reject(failure.signal.reason);
46
48
  return new Promise((resolve, reject) => {
47
- const timer = setTimeout(() => fail(`ACP ${label} timed out`), ms);
49
+ const expire = () => {
50
+ if (hold?.count)
51
+ timer = setTimeout(expire, ms);
52
+ else
53
+ fail(`ACP ${label} timed out`);
54
+ };
55
+ let timer = setTimeout(expire, ms);
56
+ if (hold) {
57
+ hold.rearm = () => {
58
+ clearTimeout(timer);
59
+ timer = setTimeout(expire, ms);
60
+ };
61
+ }
48
62
  const cleanup = () => {
49
63
  clearTimeout(timer);
50
64
  failure.signal.removeEventListener("abort", abort);
@@ -122,18 +136,25 @@ export function createAcpBridge(options) {
122
136
  child.stderr.resume();
123
137
  const client = acp.client({ name: "opencode-a2a-lite" });
124
138
  client.onRequest(acp.methods.client.session.requestPermission, async (request) => {
125
- if (stopping ||
139
+ const current = turn;
140
+ const unusable = () => stopping ||
126
141
  failure.signal.aborted ||
127
- !turn ||
128
- turn.settled ||
129
- turn.cancelled ||
130
- request.params.sessionId !== turn.sessionId)
142
+ !current ||
143
+ current.settled ||
144
+ current.cancelled ||
145
+ request.params.sessionId !== current.sessionId;
146
+ if (unusable() || !current)
147
+ return { outcome: { outcome: "cancelled" } };
148
+ const options = request.params.options;
149
+ const chosen = await askOperator(current, request.params);
150
+ if (current.onPermission && unusable())
131
151
  return { outcome: { outcome: "cancelled" } };
132
- turn.denied = true;
133
- const reject = request.params.options.find((option) => option.kind === "reject_once" || option.kind === "reject_always");
152
+ const decision = decide(options, chosen);
153
+ if (decision.denied)
154
+ current.denied = true;
134
155
  return {
135
- outcome: reject
136
- ? { outcome: "selected", optionId: reject.optionId }
156
+ outcome: decision.outcome === "selected"
157
+ ? { outcome: "selected", optionId: decision.optionId }
137
158
  : { outcome: "cancelled" },
138
159
  };
139
160
  });
@@ -196,7 +217,7 @@ export function createAcpBridge(options) {
196
217
  sessions.add(response.sessionId);
197
218
  return response;
198
219
  }
199
- async function prompt(sessionId, text, onText, onActivity) {
220
+ async function prompt(sessionId, text, onText, onActivity, onPermission) {
200
221
  const current = requireConnection(sessionId);
201
222
  if (turn)
202
223
  throw new Error("ACP prompt in progress");
@@ -204,6 +225,9 @@ export function createAcpBridge(options) {
204
225
  sessionId,
205
226
  onText,
206
227
  onActivity,
228
+ onPermission,
229
+ hold: { count: 0 },
230
+ released: Promise.withResolvers(),
207
231
  denied: false,
208
232
  cancelled: false,
209
233
  settled: false,
@@ -214,7 +238,7 @@ export function createAcpBridge(options) {
214
238
  active.completion = bounded(() => current.agent.request(acp.methods.agent.session.prompt, {
215
239
  sessionId,
216
240
  prompt: [{ type: "text", text }],
217
- }), promptTimeout, "prompt");
241
+ }), promptTimeout, "prompt", active.hold);
218
242
  try {
219
243
  const response = await active.completion;
220
244
  return active.denied ? { ...response, permissionDenied: true } : response;
@@ -239,6 +263,7 @@ export function createAcpBridge(options) {
239
263
  if (active.cancellation)
240
264
  return active.cancellation;
241
265
  active.cancelled = true;
266
+ active.released.resolve(undefined);
242
267
  active.cancellation = bounded(async () => {
243
268
  await current.agent.notify(acp.methods.agent.session.cancel, { sessionId });
244
269
  await active.completion;
@@ -17,11 +17,21 @@ export function parseOptions(args, env) {
17
17
  server: {
18
18
  workspace,
19
19
  port: parsePort(flags.get("--port") ?? env.A2A_PORT),
20
- ...(flags.has("--publish-activity") ? { executor: { activity: true } } : {}),
20
+ ...executorOptions(flags),
21
21
  ...(identity === undefined ? {} : { identity }),
22
22
  },
23
23
  };
24
24
  }
25
+ function executorOptions(flags) {
26
+ const permissions = flags.get("--permissions");
27
+ if (permissions !== undefined && permissions !== "reject" && permissions !== "ask")
28
+ throw new StartupError("arguments");
29
+ const executor = {
30
+ ...(flags.has("--publish-activity") ? { activity: true } : {}),
31
+ ...(permissions === "ask" ? { permissions: "ask" } : {}),
32
+ };
33
+ return Object.keys(executor).length ? { executor } : {};
34
+ }
25
35
  const VALUELESS = new Set(["--help", "--version", "--publish-activity"]);
26
36
  function parseFlags(args) {
27
37
  const flags = new Map();
@@ -34,7 +44,7 @@ function parseFlags(args) {
34
44
  flags.set(flag, "");
35
45
  continue;
36
46
  }
37
- if (flag !== "--workspace" && flag !== "--port")
47
+ if (flag !== "--workspace" && flag !== "--port" && flag !== "--permissions")
38
48
  throw new StartupError("arguments");
39
49
  flags.set(flag, flagValue(flag, args[index + 1]));
40
50
  index += 1;
package/dist/src/cli.js CHANGED
@@ -6,6 +6,7 @@ async function main() {
6
6
  const options = parseOptions(process.argv.slice(2), process.env);
7
7
  if (options.action === "help") {
8
8
  console.log(`Usage: opencode-a2a-lite --workspace <path> [--port <0..65535>] [--publish-activity]
9
+ [--permissions <reject|ask>]
9
10
 
10
11
  Start the foreground, unauthenticated A2A gateway.
11
12
  Linux or macOS (experimental), Bun 1.4.4, stable OpenCode 2.2.7 or newer on PATH, and configured provider required.
@@ -15,6 +16,10 @@ Linux or macOS (experimental), Bun 1.4.4, stable OpenCode 2.2.7 or newer on PATH
15
16
  --publish-activity Also publish an "activity" artifact with tool call ids, titles, kinds and
16
17
  statuses (no inputs or outputs) and the model's reasoning text.
17
18
  May reveal paths, commands or workspace data.
19
+ --permissions <reject|ask>
20
+ reject (default) rejects every OpenCode permission request. ask pauses the
21
+ task as input-required until a client answers allow or reject; anyone who
22
+ can reach this unauthenticated port can then approve tool runs.
18
23
  --help, -h Show help without starting OpenCode.
19
24
  --version, -v Print package version without starting OpenCode.
20
25
 
@@ -3,8 +3,19 @@ import { Role, TaskState } from "@a2a-js/sdk";
3
3
  import { TaskNotCancelableError } from "@a2a-js/sdk/errors";
4
4
  import { AgentEvent, } from "@a2a-js/sdk/server";
5
5
  import { BridgeError } from "./bridge-error.js";
6
+ import { createPermissionDesk } from "./permission-desk.js";
7
+ import { parseAnswer } from "./permission.js";
6
8
  export const EXPLICIT_CONTEXT = "opencode.explicitContext";
7
9
  export const ACTIVITY_EXTENSION = "urn:opencode-a2a-lite:activity:v1";
10
+ export const PERMISSIONS_EXTENSION = "urn:opencode-a2a-lite:permissions:v1";
11
+ function permissionPart(requestId, request) {
12
+ return {
13
+ content: { $case: "data", value: { permission: { requestId, ...request } } },
14
+ mediaType: "application/json",
15
+ filename: "",
16
+ metadata: undefined,
17
+ };
18
+ }
8
19
  function dataPart(value) {
9
20
  return {
10
21
  content: { $case: "data", value },
@@ -26,7 +37,25 @@ export function createAgentExecutor(bridge, options = {}) {
26
37
  if (!Number.isSafeInteger(maximum) || maximum < 1)
27
38
  throw new Error("Invalid context capacity");
28
39
  const sessions = new Map();
40
+ const desk = createPermissionDesk(options.permissionTimeoutMs ?? 120_000);
29
41
  let active;
42
+ // Handles a message that answers a pending permission request; true when it was consumed.
43
+ async function resume(ctx, status) {
44
+ const state = ctx.task?.status?.state;
45
+ const entry = desk.pending(ctx.taskId);
46
+ if (!entry) {
47
+ // A live task must not be failed by a stray follow-up; the snapshot is the whole reply.
48
+ return (state === TaskState.TASK_STATE_WORKING || state === TaskState.TASK_STATE_INPUT_REQUIRED);
49
+ }
50
+ const answer = parseAnswer(ctx.userMessage.parts, entry.requestId, entry.options);
51
+ if ("error" in answer) {
52
+ status(TaskState.TASK_STATE_INPUT_REQUIRED, `${answer.error}. Reply allow or reject.`);
53
+ return true;
54
+ }
55
+ entry.settle(answer.optionId);
56
+ await entry.finished;
57
+ return true;
58
+ }
30
59
  async function execute(ctx, bus) {
31
60
  const taskId = ctx.taskId;
32
61
  const contextId = ctx.contextId;
@@ -36,7 +65,8 @@ export function createAgentExecutor(bridge, options = {}) {
36
65
  let emitted = false;
37
66
  let activityEmitted = false;
38
67
  let terminal = false;
39
- function status(state, text) {
68
+ const finished = Promise.withResolvers();
69
+ function status(state, text, extra = []) {
40
70
  bus.publish(AgentEvent.statusUpdate({
41
71
  taskId,
42
72
  contextId,
@@ -49,7 +79,7 @@ export function createAgentExecutor(bridge, options = {}) {
49
79
  taskId,
50
80
  contextId,
51
81
  role: Role.ROLE_AGENT,
52
- parts: [textPart(text)],
82
+ parts: [textPart(text), ...extra],
53
83
  metadata: undefined,
54
84
  extensions: [],
55
85
  referenceTaskIds: [],
@@ -96,8 +126,15 @@ export function createAgentExecutor(bridge, options = {}) {
96
126
  }));
97
127
  activityEmitted = true;
98
128
  }
129
+ function clearPending() {
130
+ if (meta["opencode.permissionPending"] !== "true")
131
+ return;
132
+ meta["opencode.permissionPending"] = "false";
133
+ meta["opencode.permissionRequestId"] = "";
134
+ }
99
135
  function finish(state, text) {
100
136
  terminal = true;
137
+ clearPending();
101
138
  if (emitted)
102
139
  chunk("", true);
103
140
  if (activityEmitted)
@@ -116,6 +153,8 @@ export function createAgentExecutor(bridge, options = {}) {
116
153
  artifacts: [],
117
154
  metadata: undefined,
118
155
  }));
156
+ if (options.permissions === "ask" && ctx.task && (await resume(ctx, status)))
157
+ return;
119
158
  const message = ctx.userMessage;
120
159
  if (ctx.task || message.referenceTaskIds.length) {
121
160
  finish(TaskState.TASK_STATE_FAILED, "Use contextId without taskId or task references for follow-up turns");
@@ -167,6 +206,19 @@ export function createAgentExecutor(bridge, options = {}) {
167
206
  if (!terminal)
168
207
  activity(entry);
169
208
  }
209
+ : undefined, options.permissions === "ask"
210
+ ? async (request) => {
211
+ const entry = desk.open(taskId, request.options, finished.promise);
212
+ meta["opencode.permissionPending"] = "true";
213
+ meta["opencode.permissionRequestId"] = entry.requestId;
214
+ const label = request.kind ? `${request.title} (${request.kind})` : request.title;
215
+ status(TaskState.TASK_STATE_INPUT_REQUIRED, `Allow "${label}"? Reply allow or reject.`, [permissionPart(entry.requestId, request)]);
216
+ const answer = await entry.answer;
217
+ clearPending();
218
+ if (!terminal && !record.cancellation)
219
+ status(TaskState.TASK_STATE_WORKING);
220
+ return answer;
221
+ }
170
222
  : undefined);
171
223
  meta["opencode.stopReason"] = response.stopReason;
172
224
  if (response.permissionDenied)
@@ -177,7 +229,7 @@ export function createAgentExecutor(bridge, options = {}) {
177
229
  }
178
230
  if (response.stopReason === "cancelled") {
179
231
  finish(TaskState.TASK_STATE_CANCELED, response.permissionDenied && !record.cancellation
180
- ? "Permission request rejected; the gateway never approves tool permissions"
232
+ ? "Permission request rejected; the tool run was not approved"
181
233
  : undefined);
182
234
  return;
183
235
  }
@@ -191,6 +243,8 @@ export function createAgentExecutor(bridge, options = {}) {
191
243
  finish(TaskState.TASK_STATE_FAILED, error instanceof BridgeError ? error.message : "ACP execution failed");
192
244
  }
193
245
  finally {
246
+ desk.release(taskId);
247
+ finished.resolve();
194
248
  record.terminal = true;
195
249
  await record.cancellation?.catch(() => undefined);
196
250
  if (active === record)
@@ -0,0 +1,37 @@
1
+ import { randomUUID } from "node:crypto";
2
+ /** Tracks the one permission request awaiting a human answer per task. */
3
+ export function createPermissionDesk(timeoutMs) {
4
+ const waiting = new Map();
5
+ function open(taskId, options, finished) {
6
+ const gate = Promise.withResolvers();
7
+ const entry = {
8
+ requestId: randomUUID(),
9
+ options,
10
+ answer: gate.promise,
11
+ finished,
12
+ answered: false,
13
+ timer: setTimeout(() => entry.settle(undefined), timeoutMs),
14
+ settle(optionId) {
15
+ if (entry.answered)
16
+ return;
17
+ entry.answered = true;
18
+ clearTimeout(entry.timer);
19
+ gate.resolve(optionId);
20
+ },
21
+ };
22
+ waiting.set(taskId, entry);
23
+ return entry;
24
+ }
25
+ return {
26
+ open,
27
+ // Only an unanswered request can accept an answer; a second answer finds nothing.
28
+ pending(taskId) {
29
+ const entry = waiting.get(taskId);
30
+ return entry && !entry.answered ? entry : undefined;
31
+ },
32
+ release(taskId) {
33
+ waiting.get(taskId)?.settle(undefined);
34
+ waiting.delete(taskId);
35
+ },
36
+ };
37
+ }
@@ -0,0 +1,71 @@
1
+ const OFFERED = new Set(["allow_once", "reject_once", "reject_always"]);
2
+ const ALLOW = new Set(["allow", "approve", "yes"]);
3
+ const REJECT = new Set(["reject", "deny", "no"]);
4
+ // allow_always would change OpenCode's permission rules for later sessions, so it is never offered.
5
+ export function offeredOptions(options) {
6
+ return options.filter((option) => OFFERED.has(option.kind));
7
+ }
8
+ export function decide(options, chosen) {
9
+ const offered = offeredOptions(options);
10
+ const pick = offered.find((option) => option.optionId === chosen);
11
+ if (pick?.kind === "allow_once")
12
+ return { outcome: "selected", optionId: pick.optionId, denied: false };
13
+ const reject = pick ?? offered.find((option) => option.kind.startsWith("reject"));
14
+ return reject
15
+ ? { outcome: "selected", optionId: reject.optionId, denied: true }
16
+ : { outcome: "cancelled", denied: true };
17
+ }
18
+ function dataAnswer(value) {
19
+ if (typeof value !== "object" || value === null || !("permissionResponse" in value))
20
+ return;
21
+ const answer = value.permissionResponse;
22
+ if (typeof answer !== "object" || answer === null)
23
+ return;
24
+ const { requestId, optionId } = answer;
25
+ return {
26
+ ...(typeof requestId === "string" ? { requestId } : {}),
27
+ ...(typeof optionId === "string" ? { optionId } : {}),
28
+ };
29
+ }
30
+ export function parseAnswer(parts, requestId, options) {
31
+ const offered = offeredOptions(options);
32
+ const data = parts.flatMap((part) => part.content?.$case === "data" ? [dataAnswer(part.content.value)] : [])[0];
33
+ if (data) {
34
+ if (data.requestId !== requestId)
35
+ return { error: "The permission request id does not match" };
36
+ const pick = offered.find((option) => option.optionId === data.optionId);
37
+ return pick ? { optionId: pick.optionId } : { error: "The option is not offered" };
38
+ }
39
+ const text = parts
40
+ .map((part) => (part.content?.$case === "text" ? part.content.value : ""))
41
+ .join(" ")
42
+ .trim()
43
+ .toLowerCase();
44
+ const wanted = ALLOW.has(text) ? "allow_once" : REJECT.has(text) ? "reject" : undefined;
45
+ const pick = offered.find((option) => option.kind.startsWith(wanted ?? "\0"));
46
+ return pick ? { optionId: pick.optionId } : { error: "Unrecognized answer" };
47
+ }
48
+ // Asks the operator while holding the prompt deadline; cancellation or a failing callback means no answer.
49
+ export async function askOperator(turn, params) {
50
+ if (!turn.onPermission)
51
+ return;
52
+ turn.hold.count += 1;
53
+ try {
54
+ return await Promise.race([
55
+ turn.released.promise,
56
+ turn.onPermission({
57
+ title: params.toolCall.title ?? "tool",
58
+ ...(params.toolCall.kind ? { kind: params.toolCall.kind } : {}),
59
+ options: offeredOptions(params.options),
60
+ }),
61
+ ]);
62
+ }
63
+ catch {
64
+ return undefined;
65
+ }
66
+ finally {
67
+ turn.hold.count -= 1;
68
+ if (!turn.hold.count)
69
+ turn.hold.rearm?.();
70
+ }
71
+ }
@@ -5,6 +5,7 @@ export function createRequestHandler(card, executor, timeout) {
5
5
  const memory = new InMemoryTaskStore();
6
6
  const buses = new DefaultExecutionEventBusManager();
7
7
  const listeners = new Map();
8
+ const interrupted = (task) => task.status?.state === TaskState.TASK_STATE_INPUT_REQUIRED;
8
9
  const terminal = (task) => task.status &&
9
10
  ![TaskState.TASK_STATE_SUBMITTED, TaskState.TASK_STATE_WORKING].includes(task.status.state);
10
11
  const store = {
@@ -20,7 +21,8 @@ export function createRequestHandler(card, executor, timeout) {
20
21
  // SDK 1.3's CancelTask creates a second ResultManager on the live bus, so
21
22
  // cancellation-time artifact appends are persisted twice. Keep one consumer;
22
23
  // await that consumer's terminal save through the public TaskStore interface.
23
- handler.cancelTask = async (params, context) => {
24
+ const stock = handler.cancelTask.bind(handler);
25
+ const cancelWithOwner = async (params, context) => {
24
26
  const task = await handler.getTask(params, context);
25
27
  if (task.status?.state === TaskState.TASK_STATE_CANCELED)
26
28
  return task;
@@ -51,5 +53,10 @@ export function createRequestHandler(card, executor, timeout) {
51
53
  listeners.delete(params.id);
52
54
  }
53
55
  };
56
+ // The original event consumer ended at INPUT_REQUIRED, so nothing else would persist the
57
+ // canceled state; the stock path attaches its own single consumer, which cannot duplicate.
58
+ handler.cancelTask = async (params, context) => interrupted(await handler.getTask(params, context))
59
+ ? stock(params, context)
60
+ : cancelWithOwner(params, context);
54
61
  return handler;
55
62
  }
@@ -7,7 +7,7 @@ import manifest from "../package.json" with { type: "json" };
7
7
  import { A2A_PROTOCOL_VERSION, AGENT_CARD_PATH } from "@a2a-js/sdk";
8
8
  import { agentCardHandler, jsonRpcHandler, UserBuilder } from "@a2a-js/sdk/server/express";
9
9
  import { createAcpBridge } from "./acp-client.js";
10
- import { ACTIVITY_EXTENSION, createAgentExecutor, EXPLICIT_CONTEXT, } from "./executor.js";
10
+ import { ACTIVITY_EXTENSION, createAgentExecutor, EXPLICIT_CONTEXT, PERMISSIONS_EXTENSION, } from "./executor.js";
11
11
  import { createRequestHandler } from "./request-handler.js";
12
12
  import { parseOptions } from "./cli-options.js";
13
13
  import { reportStartupError, StartupError } from "./startup-error.js";
@@ -104,16 +104,28 @@ export function createGateway(options) {
104
104
  streaming: true,
105
105
  pushNotifications: false,
106
106
  extendedAgentCard: false,
107
- extensions: options.executor?.activity
108
- ? [
109
- {
110
- uri: ACTIVITY_EXTENSION,
111
- description: "Adds an optional 'activity' artifact of tool call ids, titles, kinds, statuses and reasoning text.",
112
- required: false,
113
- params: undefined,
114
- },
115
- ]
116
- : [],
107
+ extensions: [
108
+ ...(options.executor?.activity
109
+ ? [
110
+ {
111
+ uri: ACTIVITY_EXTENSION,
112
+ description: "Adds an optional 'activity' artifact of tool call ids, titles, kinds, statuses and reasoning text.",
113
+ required: false,
114
+ params: undefined,
115
+ },
116
+ ]
117
+ : []),
118
+ ...(options.executor?.permissions === "ask"
119
+ ? [
120
+ {
121
+ uri: PERMISSIONS_EXTENSION,
122
+ description: "A permission request pauses the task as input-required; answer on the same task with 'allow' or 'reject', or a data part {permissionResponse:{requestId,optionId}}.",
123
+ required: false,
124
+ params: undefined,
125
+ },
126
+ ]
127
+ : []),
128
+ ],
117
129
  },
118
130
  securitySchemes: {},
119
131
  securityRequirements: [],
@@ -200,6 +212,8 @@ export async function launchGateway(options) {
200
212
  const cardUrl = new URL(".well-known/agent-card.json", ready.url).href;
201
213
  status("ready", `gateway · ${ready.url}`);
202
214
  status("workspace", options.workspace);
215
+ if (options.executor?.permissions === "ask")
216
+ status("permissions", "ask · any client that can reach this port can approve tool runs");
203
217
  if (options.executor?.activity)
204
218
  status("activity", "tool calls and reasoning text are published; they may reveal paths, commands or workspace data");
205
219
  status("agent card", cardUrl);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tbrandenburg/opencode-a2a-lite",
3
- "version": "0.4.1",
3
+ "version": "0.5.0",
4
4
  "description": "OpenCode ACP to A2A gateway for trusted workspaces",
5
5
  "license": "MIT",
6
6
  "repository": {