@threadbase-sh/streamer 1.62.0 → 1.64.0

package/dist/claude-flags.d.ts

@@ -0,0 +1,76 @@
+/** Claude Code `--permission-mode` values, as accepted by CLI v2.1.x. */
+export declare const PERMISSION_MODES: readonly ["acceptEdits", "auto", "bypassPermissions", "manual", "dontAsk", "plan"];
+export type PermissionMode = (typeof PERMISSION_MODES)[number];
+export declare function isPermissionMode(value: unknown): value is PermissionMode;
+export declare const DANGEROUS_PERMISSION_MODES: readonly PermissionMode[];
+export declare function isDangerousPermissionMode(mode: PermissionMode): boolean;
+/**
+ * The mode sessions will actually spawn with, for callers that need to know
+ * before any spawn happens (the boot warning). Mirrors the precedence
+ * `StreamerServer.spawnFlagOverrides()` applies — `claudeFlags.permissionMode`
+ * wins over the `--default-permission-mode` fallback — so the two must not
+ * drift: a warning that reads the fallback would stay silent while a
+ * `claude_flags:` bypass is what actually reaches argv.
+ */
+export declare function effectivePermissionMode(flags: ClaudeFlagValues | undefined, fallback: string | undefined): PermissionMode | undefined;
+/** Claude Code `--effort` levels, as accepted by CLI v2.1.x. */
+export declare const EFFORT_LEVELS: readonly ["low", "medium", "high", "xhigh", "max"];
+export type EffortLevel = (typeof EFFORT_LEVELS)[number];
+export declare function isEffortLevel(value: unknown): value is EffortLevel;
+export type FlagValueType = "boolean" | "string" | "enum" | "list";
+/** How risky enabling a flag is. Drives the client's confirmation UX. */
+export type FlagRisk = "low" | "elevated" | "dangerous";
+export interface FlagDefinition {
+    /** Stable config/wire key. Never the CLI spelling. */
+    id: string;
+    /** The literal CLI token, e.g. "--add-dir". */
+    flag: string;
+    valueType: FlagValueType;
+    /** Allowed values when valueType === "enum". */
+    enumValues?: readonly string[];
+    /**
+     * Baseline risk. `permissionMode` is the exception: it is only dangerous for
+     * the values in DANGEROUS_PERMISSION_MODES, so clients must call
+     * `flagValueRisk()` rather than reading this field directly.
+     */
+    risk: FlagRisk;
+}
+export type ClaudeFlagValue = string | string[] | boolean;
+export type ClaudeFlagValues = Record<string, ClaudeFlagValue>;
+export declare const CLAUDE_FLAGS: readonly FlagDefinition[];
+export declare function findFlag(id: string): FlagDefinition | undefined;
+/**
+ * Effective risk of a specific value. Only `permissionMode` is value-dependent
+ * (`acceptEdits` is routine; `bypassPermissions` is not).
+ */
+export declare function flagValueRisk(id: string, value: ClaudeFlagValue): FlagRisk;
+/**
+ * Drop everything that isn't a known id carrying a well-typed value.
+ *
+ * This is a TRUST BOUNDARY, not a convenience: values arrive from a
+ * user-editable server.yaml and from HTTP, and they become process argv. Never
+ * skip it. Unknown/invalid entries are dropped rather than throwing so one bad
+ * key can't prevent the server from booting.
+ */
+export declare function validateFlagValues(raw: unknown): ClaudeFlagValues;
+/**
+ * Split a free-text extra-args string into argv tokens, honouring single and
+ * double quotes so a path with spaces survives. Deliberately not a full shell
+ * parser — no variable expansion, no globbing, no escapes beyond the quotes.
+ */
+export declare function tokenizeExtraArgs(input: string | undefined): string[];
+/**
+ * Turn validated flag values + extra args into argv tokens.
+ *
+ * The SPAWN_POSITIONAL_FLAG_IDS are intentionally NOT emitted here: both PTY
+ * spawn paths already pass them as explicit positionals, and emitting them
+ * twice would put a duplicate flag on the command line. They flow through
+ * `options.permissionMode` / `options.model` / `options.effort` instead, which
+ * StreamerServer.spawnFlagOverrides() sources from these same flag values.
+ *
+ * Extra args land LAST so the escape hatch can override anything the allowlist
+ * set.
+ */
+export declare function buildFlagArgs(values: ClaudeFlagValues | undefined, extraArgs?: string): string[];
+export declare function buildSettingsJson(permissionMode: PermissionMode): string;
+//# sourceMappingURL=claude-flags.d.ts.map

package/dist/claude-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-flags.d.ts","sourceRoot":"","sources":["../src/claude-flags.ts"],"names":[],"mappings":"AAcA,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,YAC3B,aAAa,EACb,MAAM,EACN,mBAAmB,EACnB,QAAQ,EACR,SAAS,EACT,MAAM,CACE,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAOD,eAAO,MAAM,0BAA0B,EAAE,SAAS,cAAc,EAG/D,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAEvE;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,gBAAgB,GAAG,SAAS,EACnC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,cAAc,GAAG,SAAS,CAG5B;AAED,gEAAgE;AAChE,eAAO,MAAM,aAAa,YAAI,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAU,CAAC;AAEhF,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnE,yEAAyE;AACzE,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,UAAU,GAAG,WAAW,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,aAAa,CAAC;IACzB,gDAAgD;IAChD,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B;;;;OAIG;IACH,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAyB/D,eAAO,MAAM,YAAY,EAAE,SAAS,cAAc,EAajD,CAAC;AAQF,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE/D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,QAAQ,CAO1E;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CA2BjE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CA+BrE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAsBhG;AAUD,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,cAAc,GAAG,MAAM,CAMxE"}