agent-director 0.6.0 → 0.6.2

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
@@ -172,10 +172,13 @@ prompts that Claude Code renders before the session becomes interactive — for
172
172
  example the `--dangerously-load-development-channels` safety warning. `ended`
173
173
  and `missing` Spawns are still rejected regardless of the flag.
174
174
 
175
+ Send an empty string with `allow_pending: true` to press Enter and dismiss the
176
+ pre-`SessionStart` prompt:
177
+
175
178
  ```ts
176
179
  await client.sendKeys({
177
180
  claude_instance_id: "<id>",
178
- text: "", // press Enter to dismiss the pre-SessionStart prompt
181
+ text: "",
179
182
  allow_pending: true,
180
183
  });
181
184
  ```
package/dist/errors.d.ts CHANGED
@@ -218,6 +218,18 @@ export declare class ErrNoOpenPermissionRequest extends AgentDirectorError {
218
218
  /** Mirrors ErrAlreadyDecided (package: store) */
219
219
  export declare class ErrAlreadyDecided extends AgentDirectorError {
220
220
  }
221
+ /** Mirrors ErrPermissionRequestNotFound (package: store) */
222
+ export declare class ErrPermissionRequestNotFound extends AgentDirectorError {
223
+ }
224
+ /** Mirrors ErrAmbiguousRequest (package: store) */
225
+ export declare class ErrAmbiguousRequest extends AgentDirectorError {
226
+ }
227
+ /** Mirrors ErrMissingRequestToken (package: api) */
228
+ export declare class ErrMissingRequestToken extends AgentDirectorError {
229
+ }
230
+ /** Mirrors ErrInvalidFlags (package: api) */
231
+ export declare class ErrInvalidFlags extends AgentDirectorError {
232
+ }
221
233
  /**
222
234
  * errorFromEnvelope creates a typed AgentDirectorError subclass from the
223
235
  * subprocess error envelope fields.
package/dist/index.d.ts CHANGED
@@ -2,7 +2,7 @@
2
2
  * Public entry point for agent-director.
3
3
  */
4
4
  export { Client } from "./client.js";
5
- export { AgentDirectorError, ErrClientClosed, ErrUnsupportedPlatform, ErrPlatformPackageMissing, ErrBunVersionTooOld, ErrCliNotExecutable, ErrConsumerSignal, ErrCallTimeout, ErrUnknownErrorName, errorFromEnvelope, ErrCwdMissing, ErrCwdNotAPath, ErrCwdNotFound, ErrCwdNotADirectory, ErrRelayModeInvalid, ErrSpawnDeniedFlag, ErrReservedEnvKey, ErrInstanceIdCollision, ErrTmuxSessionNameEmpty, ErrTmuxSessionNameInvalid, ErrTmuxSessionNameTooLong, ErrSpawnNotFound, ErrTmuxNotAvailable, ErrTmuxSessionCreate, ErrTmuxSendKeys, ErrTmuxCaptureFailed, ErrSpawnNotInteractive, ErrSendKeysWhileRelayed, ErrSpawnNotPausable, ErrPauseTimeout, ErrListInvalidLabel, ErrTemplateNameUnsafe, ErrTemplateNotFound, ErrTemplateMalformed, ErrTemplateExists, ErrProbeUnsupported, ErrSpawnNotResumable, ErrNoSessionId, ErrJsonlMissing, ErrRelayModeOff, ErrInvalidDecision, ErrNoOpenPermissionRequest, ErrAlreadyDecided, } from "./errors.js";
5
+ export { AgentDirectorError, ErrClientClosed, ErrUnsupportedPlatform, ErrPlatformPackageMissing, ErrBunVersionTooOld, ErrCliNotExecutable, ErrConsumerSignal, ErrCallTimeout, ErrUnknownErrorName, errorFromEnvelope, ErrCwdMissing, ErrCwdNotAPath, ErrCwdNotFound, ErrCwdNotADirectory, ErrRelayModeInvalid, ErrSpawnDeniedFlag, ErrReservedEnvKey, ErrInstanceIdCollision, ErrTmuxSessionNameEmpty, ErrTmuxSessionNameInvalid, ErrTmuxSessionNameTooLong, ErrSpawnNotFound, ErrTmuxNotAvailable, ErrTmuxSessionCreate, ErrTmuxSendKeys, ErrTmuxCaptureFailed, ErrSpawnNotInteractive, ErrSendKeysWhileRelayed, ErrSpawnNotPausable, ErrPauseTimeout, ErrListInvalidLabel, ErrTemplateNameUnsafe, ErrTemplateNotFound, ErrTemplateMalformed, ErrTemplateExists, ErrProbeUnsupported, ErrSpawnNotResumable, ErrNoSessionId, ErrJsonlMissing, ErrRelayModeOff, ErrInvalidDecision, ErrNoOpenPermissionRequest, ErrAlreadyDecided, ErrPermissionRequestNotFound, ErrAmbiguousRequest, ErrMissingRequestToken, ErrInvalidFlags, } from "./errors.js";
6
6
  export type { ClientOptions, Logger } from "./types.js";
7
7
  export type { VerbSummary, PermissionRequestInfo, ListRow } from "./types.js";
8
- export type { SpawnParams, SpawnResult, StatusParams, StatusResult, GetParams, GetResult, SendKeysParams, SendKeysResult, ReadPaneParams, ReadPaneResult, KillParams, KillResult, DecideParams, DecideResult, ResumeParams, ResumeResult, FindMissingParams, FindMissingResult, ExpireParams, ExpireResult, DeleteParams, DeleteResult, MakeTemplateParams, MakeTemplateResult, ListParams, ListResult, PauseParams, PauseResult, VersionParams, VersionResult, } from "./types.js";
8
+ export type { SpawnParams, SpawnResult, StatusParams, StatusResult, GetParams, GetResult, SendKeysParams, SendKeysResult, ReadPaneParams, ReadPaneResult, KillParams, KillResult, DecideParams, DecideResult, GetPermissionParams, GetPermissionResult, ResumeParams, ResumeResult, FindMissingParams, FindMissingResult, ExpireParams, ExpireResult, DeleteParams, DeleteResult, MakeTemplateParams, MakeTemplateResult, ListParams, ListResult, PauseParams, PauseResult, VersionParams, VersionResult, } from "./types.js";
package/dist/index.js CHANGED
@@ -48,11 +48,14 @@ __export(exports_errors, {
48
48
  ErrRelayModeInvalid: () => ErrRelayModeInvalid,
49
49
  ErrProbeUnsupported: () => ErrProbeUnsupported,
50
50
  ErrPlatformPackageMissing: () => ErrPlatformPackageMissing,
51
+ ErrPermissionRequestNotFound: () => ErrPermissionRequestNotFound,
51
52
  ErrPauseTimeout: () => ErrPauseTimeout,
52
53
  ErrNoSessionId: () => ErrNoSessionId,
53
54
  ErrNoOpenPermissionRequest: () => ErrNoOpenPermissionRequest,
55
+ ErrMissingRequestToken: () => ErrMissingRequestToken,
54
56
  ErrListInvalidLabel: () => ErrListInvalidLabel,
55
57
  ErrJsonlMissing: () => ErrJsonlMissing,
58
+ ErrInvalidFlags: () => ErrInvalidFlags,
56
59
  ErrInvalidDecision: () => ErrInvalidDecision,
57
60
  ErrInstanceIdCollision: () => ErrInstanceIdCollision,
58
61
  ErrCwdNotFound: () => ErrCwdNotFound,
@@ -64,6 +67,7 @@ __export(exports_errors, {
64
67
  ErrCliNotExecutable: () => ErrCliNotExecutable,
65
68
  ErrCallTimeout: () => ErrCallTimeout,
66
69
  ErrBunVersionTooOld: () => ErrBunVersionTooOld,
70
+ ErrAmbiguousRequest: () => ErrAmbiguousRequest,
67
71
  ErrAlreadyDecided: () => ErrAlreadyDecided,
68
72
  AgentDirectorError: () => AgentDirectorError
69
73
  });
@@ -268,6 +272,18 @@ class ErrNoOpenPermissionRequest extends AgentDirectorError {
268
272
 
269
273
  class ErrAlreadyDecided extends AgentDirectorError {
270
274
  }
275
+
276
+ class ErrPermissionRequestNotFound extends AgentDirectorError {
277
+ }
278
+
279
+ class ErrAmbiguousRequest extends AgentDirectorError {
280
+ }
281
+
282
+ class ErrMissingRequestToken extends AgentDirectorError {
283
+ }
284
+
285
+ class ErrInvalidFlags extends AgentDirectorError {
286
+ }
271
287
  var ERROR_TABLE = {
272
288
  ErrCwdMissing,
273
289
  ErrCwdNotAPath,
@@ -283,6 +299,8 @@ var ERROR_TABLE = {
283
299
  ErrSpawnNotFound,
284
300
  ErrNoOpenPermissionRequest,
285
301
  ErrAlreadyDecided,
302
+ ErrPermissionRequestNotFound,
303
+ ErrAmbiguousRequest,
286
304
  ErrTmuxNotAvailable,
287
305
  ErrTmuxSessionCreate,
288
306
  ErrTmuxSendKeys,
@@ -297,6 +315,8 @@ var ERROR_TABLE = {
297
315
  ErrJsonlMissing,
298
316
  ErrRelayModeOff,
299
317
  ErrInvalidDecision,
318
+ ErrMissingRequestToken,
319
+ ErrInvalidFlags,
300
320
  ErrTemplateNameUnsafe,
301
321
  ErrTemplateNotFound,
302
322
  ErrTemplateMalformed,
@@ -427,6 +447,8 @@ function buildVerbFlags(verb, params) {
427
447
  return buildKill(params);
428
448
  case "decide":
429
449
  return buildDecide(params);
450
+ case "get-permission":
451
+ return buildGetPermission(params);
430
452
  case "resume":
431
453
  return buildResume(params);
432
454
  case "find-missing":
@@ -527,10 +549,15 @@ function buildDecide(p) {
527
549
  "--decision",
528
550
  p.decision
529
551
  ];
552
+ if (p.request_token !== undefined)
553
+ f.push("--request-token", p.request_token);
530
554
  if (p.reason !== undefined)
531
555
  f.push("--reason", p.reason);
532
556
  return f;
533
557
  }
558
+ function buildGetPermission(p) {
559
+ return ["get-permission", "--request-token", p.request_token];
560
+ }
534
561
  function buildResume(p) {
535
562
  return ["resume", "--claude-instance-id", p.claude_instance_id];
536
563
  }
@@ -779,6 +806,11 @@ var catalog_default = [
779
806
  package: "api",
780
807
  description: ""
781
808
  },
809
+ {
810
+ name: "ErrInvalidFlags",
811
+ package: "api",
812
+ description: ""
813
+ },
782
814
  {
783
815
  name: "ErrMissingRequestToken",
784
816
  package: "api",
@@ -833,7 +865,7 @@ function throwFromEnvelope(verb, envelope) {
833
865
  // package.json
834
866
  var package_default = {
835
867
  name: "agent-director",
836
- version: "0.6.0",
868
+ version: "0.6.2",
837
869
  type: "module",
838
870
  os: [
839
871
  "linux",
@@ -876,8 +908,8 @@ var package_default = {
876
908
  "verify-installed-pkg": "bun run scripts/verify-installed-pkg.ts"
877
909
  },
878
910
  optionalDependencies: {
879
- "@agent-director/linux-x64": "^0.6.0",
880
- "@agent-director/darwin-arm64": "^0.6.0"
911
+ "@agent-director/linux-x64": "^0.6.2",
912
+ "@agent-director/darwin-arm64": "^0.6.2"
881
913
  },
882
914
  devDependencies: {
883
915
  typescript: ">=5.2.0",
@@ -1061,6 +1093,10 @@ class SubprocessClient {
1061
1093
  this.#assertOpen();
1062
1094
  return this.#enqueue("decide", params);
1063
1095
  }
1096
+ async getPermission(params) {
1097
+ this.#assertOpen();
1098
+ return this.#enqueue("get-permission", params);
1099
+ }
1064
1100
  async resume(params) {
1065
1101
  this.#assertOpen();
1066
1102
  return this.#enqueue("resume", params);
@@ -1121,11 +1157,14 @@ export {
1121
1157
  ErrRelayModeInvalid,
1122
1158
  ErrProbeUnsupported,
1123
1159
  ErrPlatformPackageMissing,
1160
+ ErrPermissionRequestNotFound,
1124
1161
  ErrPauseTimeout,
1125
1162
  ErrNoSessionId,
1126
1163
  ErrNoOpenPermissionRequest,
1164
+ ErrMissingRequestToken,
1127
1165
  ErrListInvalidLabel,
1128
1166
  ErrJsonlMissing,
1167
+ ErrInvalidFlags,
1129
1168
  ErrInvalidDecision,
1130
1169
  ErrInstanceIdCollision,
1131
1170
  ErrCwdNotFound,
@@ -1137,6 +1176,7 @@ export {
1137
1176
  ErrCliNotExecutable,
1138
1177
  ErrCallTimeout,
1139
1178
  ErrBunVersionTooOld,
1179
+ ErrAmbiguousRequest,
1140
1180
  ErrAlreadyDecided,
1141
1181
  SubprocessClient as Client,
1142
1182
  AgentDirectorError
@@ -2,7 +2,7 @@
2
2
  * errorMap.ts — catalog-driven static error map for the subprocess Client.
3
3
  *
4
4
  * Builds a `Map<string, ErrConstructor>` at module load time by iterating
5
- * `pkg/api/errnames/catalog.json` (33 entries as of 2026-05-25). The map
5
+ * `pkg/api/errnames/catalog.json` (37 entries as of 2026-05-31). The map
6
6
  * keys are the canonical `err_name` strings (e.g. "ErrSpawnNotFound");
7
7
  * values are the typed constructors already exported from `src/errors.ts`.
8
8
  *
@@ -29,7 +29,7 @@
29
29
  * Internal — NOT re-exported from src/index.ts until Epic B.
30
30
  */
31
31
  import type { ClientOptions } from "../types.js";
32
- import type { SpawnParams, SpawnResult, StatusParams, StatusResult, GetParams, GetResult, SendKeysParams, SendKeysResult, ReadPaneParams, ReadPaneResult, KillParams, KillResult, DecideParams, DecideResult, ResumeParams, ResumeResult, FindMissingParams, FindMissingResult, ExpireParams, ExpireResult, DeleteParams, DeleteResult, MakeTemplateParams, MakeTemplateResult, ListParams, ListResult, PauseParams, PauseResult, VersionParams, VersionResult } from "../types.js";
32
+ import type { SpawnParams, SpawnResult, StatusParams, StatusResult, GetParams, GetResult, SendKeysParams, SendKeysResult, ReadPaneParams, ReadPaneResult, KillParams, KillResult, DecideParams, DecideResult, GetPermissionParams, GetPermissionResult, ResumeParams, ResumeResult, FindMissingParams, FindMissingResult, ExpireParams, ExpireResult, DeleteParams, DeleteResult, MakeTemplateParams, MakeTemplateResult, ListParams, ListResult, PauseParams, PauseResult, VersionParams, VersionResult } from "../types.js";
33
33
  /**
34
34
  * SubprocessClient drives the bundled agent-director CLI binary as one
35
35
  * subprocess per verb call. Intended as the replacement for the FFI Client
@@ -82,6 +82,8 @@ export declare class SubprocessClient {
82
82
  kill(params: KillParams): Promise<KillResult>;
83
83
  /** decide — resolve a pending permission request. */
84
84
  decide(params: DecideParams): Promise<DecideResult>;
85
+ /** getPermission — fetch a permission_requests row by request_token. */
86
+ getPermission(params: GetPermissionParams): Promise<GetPermissionResult>;
85
87
  /** resume — restart a terminated Spawn. */
86
88
  resume(params: ResumeParams): Promise<ResumeResult>;
87
89
  /** findMissing — reconcile Spawns whose tmux sessions have disappeared. */
@@ -6,14 +6,14 @@
6
6
  * pkg/api/manifest/manifest.go. It includes every verb where `Callable: true`
7
7
  * and excludes the three non-callable verbs (help, serve, hook).
8
8
  *
9
- * Currently 15 callable verbs: spawn, status, get, send-keys, read-pane,
10
- * kill, decide, resume, find-missing, expire, delete, make-template, list,
11
- * pause, version.
9
+ * Currently 16 callable verbs: spawn, status, get, send-keys, read-pane,
10
+ * kill, decide, get-permission, resume, find-missing, expire, delete,
11
+ * make-template, list, pause, version.
12
12
  *
13
13
  * NOTE: `help` has `Callable: false` in manifest.go (source of truth); it is
14
14
  * intentionally excluded here. The .go source wins.
15
15
  */
16
16
  /** All callable verbs in their canonical kebab form (matches manifest). */
17
- export declare const VERBS: readonly ["spawn", "status", "get", "send-keys", "read-pane", "kill", "decide", "resume", "find-missing", "expire", "delete", "make-template", "list", "pause", "version"];
17
+ export declare const VERBS: readonly ["spawn", "status", "get", "send-keys", "read-pane", "kill", "decide", "get-permission", "resume", "find-missing", "expire", "delete", "make-template", "list", "pause", "version"];
18
18
  /** Union type of every callable verb name. */
19
19
  export type VerbName = (typeof VERBS)[number];
package/dist/types.d.ts CHANGED
@@ -84,6 +84,8 @@ export interface VerbSummary {
84
84
  export interface PermissionRequestInfo {
85
85
  /** Autoincrement primary key of the permission_requests row. */
86
86
  request_id: number;
87
+ /** UUIDv4 token minted by runRelay for this request. Pass to the decide verb to target a specific row. */
88
+ request_token: string;
87
89
  /** Claude Code tool that triggered the permission request (e.g. "Bash"). */
88
90
  tool_name: string;
89
91
  /** Raw JSON string of the tool input as stored in the DB. NOT a nested object. */
@@ -229,6 +231,8 @@ export interface KillResult {
229
231
  export interface DecideParams {
230
232
  /** Id of the Spawn whose open permission request is being decided. */
231
233
  claude_instance_id: string;
234
+ /** UUIDv4 token identifying the specific permission request to decide. Required by the Go backend (ErrMissingRequestToken returned when absent); optional here for backward-compatible call shape. */
235
+ request_token?: string;
232
236
  /** Orchestrator verdict. */
233
237
  decision: "allow" | "deny";
234
238
  /** Optional free-text message surfaced to Claude on deny. */
@@ -237,6 +241,30 @@ export interface DecideParams {
237
241
  /** Mirrors pkg/api/decide.go::DecideResult (empty; reserved for future fields). */
238
242
  export interface DecideResult {
239
243
  }
244
+ /** Mirrors pkg/api.GetPermissionParams (json tags). */
245
+ export interface GetPermissionParams {
246
+ /** UUIDv4 token identifying the permission_requests row to fetch. Required; empty string rejected by the backend. */
247
+ request_token: string;
248
+ }
249
+ /** Mirrors pkg/api/get_permission.go::GetPermissionResult */
250
+ export interface GetPermissionResult {
251
+ /** UUIDv4 token the row is keyed under (echoed back). */
252
+ request_token: string;
253
+ /** Autoincrement primary key of the permission_requests row. */
254
+ request_id: number;
255
+ /** Claude Code tool that triggered the permission request (e.g. "Bash", "Write"). */
256
+ tool_name: string;
257
+ /** Raw JSON string of the tool's input as stored in the DB. NOT a nested object — callers parse it themselves. */
258
+ tool_input: string;
259
+ /** RFC3339 timestamp when the permission request row was created. */
260
+ requested_at: string;
261
+ /** "allow" or "deny" once decided; null while the row is open (decision IS NULL in the DB). */
262
+ decision?: "allow" | "deny" | null;
263
+ /** Canonical decision-reason string ("operator" | "timeout" | "find_missing") for deny rows; null for open rows and for allow rows. */
264
+ decision_reason?: "operator" | "timeout" | "find_missing" | null;
265
+ /** RFC3339 timestamp when the verdict was written; null while the row is open. */
266
+ decided_at?: string | null;
267
+ }
240
268
  /** Mirrors pkg/api.ResumeParams (json tags). */
241
269
  export interface ResumeParams {
242
270
  /** Id of the terminated Spawn to resurrect. */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-director",
3
- "version": "0.6.0",
3
+ "version": "0.6.2",
4
4
  "type": "module",
5
5
  "os": [
6
6
  "linux",
@@ -43,8 +43,8 @@
43
43
  "verify-installed-pkg": "bun run scripts/verify-installed-pkg.ts"
44
44
  },
45
45
  "optionalDependencies": {
46
- "@agent-director/linux-x64": "^0.6.0",
47
- "@agent-director/darwin-arm64": "^0.6.0"
46
+ "@agent-director/linux-x64": "^0.6.2",
47
+ "@agent-director/darwin-arm64": "^0.6.2"
48
48
  },
49
49
  "devDependencies": {
50
50
  "typescript": ">=5.2.0",
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: install-agent-director
3
3
  description: Install (or upgrade) agent-director on this machine. Runs the bundled install.sh against the user's ~/ — creates ~/.agent-director/ with the binary, warms up state.db, and injects two persistent `agent-director help` hooks into ~/.claude/settings.json (SessionStart + SessionEnd reason=compact). Use this skill when the user says "install agent-director", "set up agent-director", or "upgrade agent-director on this machine".
4
- version: 0.6.0
4
+ version: 0.6.2
5
5
  ---
6
6
 
7
7
  ## When to invoke