@namzu/sdk 27.1.0 → 29.0.0

package/dist/types/{verification → authorization}/index.d.ts

@@ -2,11 +2,20 @@ import { z } from 'zod';
 export type GateDecision = 'allow' | 'deny' | 'review';
 export interface GateEvaluationResult {
     readonly decision: GateDecision;
-    readonly matchedRule: VerificationRule | null;
+    readonly matchedRule: AuthorizationRule | null;
     readonly reason: string;
 }
-export type VerificationRule = {
+export type AuthorizationRule = {
+    /**
+     * Categories this allowance does not reach, even when
+     * `isTrustedReadOnly` says the read-only CLAIM is trustworthy.
+     * `isTrustedReadOnly` has no notion of category — it answers
+     * whether the claim can be believed, never what channel the call
+     * travelled over. See `evaluateRule`'s `allow_read_only` case for
+     * the category that actually needs this.
+     */
     type: 'allow_read_only';
+    excludeCategories?: string[];
 } | {
     type: 'deny_dangerous_patterns';
 } | {
@@ -35,7 +44,7 @@ export type VerificationRule = {
      * other tool's arguments.
      *
      * When you mean "this tool, this argument", use
-     * {@link VerificationRule} `argument_pattern` instead. This one
+     * {@link AuthorizationRule} `argument_pattern` instead. This one
      * stays for the case it is actually good at: matching anywhere in
      * the serialised input without caring where.
      */
@@ -77,12 +86,15 @@ export type VerificationRule = {
     type: 'allow_by_tier';
     tiers: string[];
 };
-export declare const VerificationRuleSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+export declare const AuthorizationRuleSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     type: z.ZodLiteral<"allow_read_only">;
+    excludeCategories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     type: "allow_read_only";
+    excludeCategories?: string[] | undefined;
 }, {
     type: "allow_read_only";
+    excludeCategories?: string[] | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"deny_dangerous_patterns">;
 }, "strip", z.ZodTypeAny, {
@@ -123,13 +135,13 @@ export declare const VerificationRuleSchema: z.ZodDiscriminatedUnion<"type", [z.
     decision: z.ZodEnum<["allow", "deny"]>;
 }, "strip", z.ZodTypeAny, {
     type: "custom_pattern";
-    target: "name" | "args" | "both";
     pattern: string;
+    target: "name" | "both" | "args";
     decision: "deny" | "allow";
 }, {
     type: "custom_pattern";
-    target: "name" | "args" | "both";
     pattern: string;
+    target: "name" | "both" | "args";
     decision: "deny" | "allow";
 }>, z.ZodObject<{
     type: z.ZodLiteral<"argument_pattern">;
@@ -159,14 +171,17 @@ export declare const VerificationRuleSchema: z.ZodDiscriminatedUnion<"type", [z.
     type: "allow_by_tier";
     tiers: string[];
 }>]>;
-export declare const VerificationGateConfigSchema: z.ZodObject<{
+export declare const AuthorizationGateConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     rules: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         type: z.ZodLiteral<"allow_read_only">;
+        excludeCategories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         type: "allow_read_only";
+        excludeCategories?: string[] | undefined;
     }, {
         type: "allow_read_only";
+        excludeCategories?: string[] | undefined;
     }>, z.ZodObject<{
         type: z.ZodLiteral<"deny_dangerous_patterns">;
     }, "strip", z.ZodTypeAny, {
@@ -207,13 +222,13 @@ export declare const VerificationGateConfigSchema: z.ZodObject<{
         decision: z.ZodEnum<["allow", "deny"]>;
     }, "strip", z.ZodTypeAny, {
         type: "custom_pattern";
-        target: "name" | "args" | "both";
         pattern: string;
+        target: "name" | "both" | "args";
         decision: "deny" | "allow";
     }, {
         type: "custom_pattern";
-        target: "name" | "args" | "both";
         pattern: string;
+        target: "name" | "both" | "args";
         decision: "deny" | "allow";
     }>, z.ZodObject<{
         type: z.ZodLiteral<"argument_pattern">;
@@ -244,12 +259,22 @@ export declare const VerificationGateConfigSchema: z.ZodObject<{
         tiers: string[];
     }>]>, "many">>;
     allowReadOnlyTools: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Narrows the LAST-resort `allow_read_only` rule the gate appends for
+     * {@link allowReadOnlyTools}. A category listed here falls through to
+     * whatever comes next — another rule, or review — even for a call
+     * `isTrustedReadOnly` would otherwise allow.
+     *
+     * `.optional()` for the reason `AllowReadOnlySchema.excludeCategories` is.
+     */
+    allowReadOnlyExcludeCategories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     denyDangerousPatterns: z.ZodDefault<z.ZodBoolean>;
     logDecisions: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     enabled: boolean;
     rules: ({
         type: "allow_read_only";
+        excludeCategories?: string[] | undefined;
     } | {
         type: "deny_dangerous_patterns";
     } | {
@@ -263,8 +288,8 @@ export declare const VerificationGateConfigSchema: z.ZodObject<{
         toolNames: string[];
     } | {
         type: "custom_pattern";
-        target: "name" | "args" | "both";
         pattern: string;
+        target: "name" | "both" | "args";
         decision: "deny" | "allow";
     } | {
         type: "argument_pattern";
@@ -279,10 +304,12 @@ export declare const VerificationGateConfigSchema: z.ZodObject<{
     allowReadOnlyTools: boolean;
     denyDangerousPatterns: boolean;
     logDecisions: boolean;
+    allowReadOnlyExcludeCategories?: string[] | undefined;
 }, {
     enabled?: boolean | undefined;
     rules?: ({
         type: "allow_read_only";
+        excludeCategories?: string[] | undefined;
     } | {
         type: "deny_dangerous_patterns";
     } | {
@@ -296,8 +323,8 @@ export declare const VerificationGateConfigSchema: z.ZodObject<{
         toolNames: string[];
     } | {
         type: "custom_pattern";
-        target: "name" | "args" | "both";
         pattern: string;
+        target: "name" | "both" | "args";
         decision: "deny" | "allow";
     } | {
         type: "argument_pattern";
@@ -310,8 +337,37 @@ export declare const VerificationGateConfigSchema: z.ZodObject<{
         tiers: string[];
     })[] | undefined;
     allowReadOnlyTools?: boolean | undefined;
+    allowReadOnlyExcludeCategories?: string[] | undefined;
     denyDangerousPatterns?: boolean | undefined;
     logDecisions?: boolean | undefined;
 }>;
-export type VerificationGateConfig = z.infer<typeof VerificationGateConfigSchema>;
+export type AuthorizationGateConfig = z.infer<typeof AuthorizationGateConfigSchema>;
+/**
+ * Old spellings, live for one deprecation window.
+ *
+ * A reader who saw `VerificationGate` expected something that verifies a
+ * claim — checks a signature, confirms an output matches a schema. This is
+ * a rule engine that decides, BEFORE a tool runs, whether the call is
+ * permitted: allow / deny / review, by name, category, tier or a pattern
+ * over the arguments. Every rule variant says so.
+ *
+ * The misreading was not academic. The module sat beside real guardrail and
+ * HITL neighbours, where "verification" actively suggests the post-hoc
+ * double-check the guardrails do.
+ */
+/**
+ * The two schemas below carry aliases too, and the task that specified this
+ * rename said they would not need any: `public-runtime.ts` records that they
+ * are deliberately not re-exported, so they looked unreachable.
+ *
+ * They were not. `public-types.ts` re-exports this module with
+ * `export type *`, which exports every name in TYPE position — including a
+ * `const`. So `import type { VerificationRuleSchema } from '@namzu/sdk'`
+ * compiled and `typeof VerificationRuleSchema` was a usable type, while
+ * importing it as a value failed with TS1362. Checked by compiling both
+ * forms against the built package rather than reading the barrel.
+ *
+ * Declared as `const` rather than `type` on purpose: a `type` alias would
+ * break `typeof`, which is the only way these were ever usable.
+ */
 //# sourceMappingURL=index.d.ts.map

package/dist/types/authorization/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/authorization/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;AAEtD,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;IAC/B,QAAQ,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,MAAM,iBAAiB,GAC1B;IACA;;;;;;;OAOG;IACH,IAAI,EAAE,iBAAiB,CAAA;IACvB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC3B,GACD;IAAE,IAAI,EAAE,yBAAyB,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,GAC7C;IACA;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,EAAE,gBAAgB,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;IAChC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAA;CACzB,GACD;IACA;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,IAAI,EAAE,kBAAkB,CAAA;IACxB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAA;CACzB,GACD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AA6C7C,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASlC,CAAA;AAEF,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIzC;;;;;;;OAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIF,CAAA;AAEF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAEnF;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;;;;;;GAcG"}

package/dist/types/authorization/index.js

@@ -0,0 +1,99 @@
+import { z } from 'zod';
+import { MAX_CUSTOM_PATTERN_LENGTH } from '../../constants/authorization/index.js';
+const AllowReadOnlySchema = z.object({
+    type: z.literal('allow_read_only'),
+    // Optional, no default: a rule written before this field existed still
+    // parses and still means what it always meant. `.default([])` would make
+    // `AuthorizationGateConfig` — which is `z.infer` of the schema below, i.e.
+    // the zod OUTPUT type — require the field on every hand-authored literal
+    // in this repo and in every consumer, for no behavioural gain: `undefined`
+    // and `[]` are read identically.
+    excludeCategories: z.array(z.string()).optional(),
+});
+const DenyDangerousPatternsSchema = z.object({ type: z.literal('deny_dangerous_patterns') });
+const AllowByCategorySchema = z.object({
+    type: z.literal('allow_by_category'),
+    categories: z.array(z.string()),
+});
+const AllowByNameSchema = z.object({
+    type: z.literal('allow_by_name'),
+    toolNames: z.array(z.string()),
+});
+const DenyByNameSchema = z.object({
+    type: z.literal('deny_by_name'),
+    toolNames: z.array(z.string()),
+});
+const CustomPatternSchema = z.object({
+    type: z.literal('custom_pattern'),
+    pattern: z.string().max(MAX_CUSTOM_PATTERN_LENGTH),
+    target: z.enum(['name', 'args', 'both']),
+    decision: z.enum(['allow', 'deny']),
+});
+const ArgumentPatternSchema = z.object({
+    type: z.literal('argument_pattern'),
+    toolNames: z.array(z.string()).min(1),
+    // A rule that names no argument would silently apply to none, which is the
+    // fail-open shape this rule type exists to remove.
+    argument: z.string().min(1),
+    pattern: z.string().max(MAX_CUSTOM_PATTERN_LENGTH),
+    decision: z.enum(['allow', 'deny']),
+});
+const AllowByTierSchema = z.object({
+    type: z.literal('allow_by_tier'),
+    tiers: z.array(z.string()),
+});
+export const AuthorizationRuleSchema = z.discriminatedUnion('type', [
+    AllowReadOnlySchema,
+    DenyDangerousPatternsSchema,
+    AllowByCategorySchema,
+    AllowByNameSchema,
+    DenyByNameSchema,
+    CustomPatternSchema,
+    ArgumentPatternSchema,
+    AllowByTierSchema,
+]);
+export const AuthorizationGateConfigSchema = z.object({
+    enabled: z.boolean().default(false),
+    rules: z.array(AuthorizationRuleSchema).default([]),
+    allowReadOnlyTools: z.boolean().default(false),
+    /**
+     * Narrows the LAST-resort `allow_read_only` rule the gate appends for
+     * {@link allowReadOnlyTools}. A category listed here falls through to
+     * whatever comes next — another rule, or review — even for a call
+     * `isTrustedReadOnly` would otherwise allow.
+     *
+     * `.optional()` for the reason `AllowReadOnlySchema.excludeCategories` is.
+     */
+    allowReadOnlyExcludeCategories: z.array(z.string()).optional(),
+    denyDangerousPatterns: z.boolean().default(false),
+    logDecisions: z.boolean().default(true),
+});
+/**
+ * Old spellings, live for one deprecation window.
+ *
+ * A reader who saw `VerificationGate` expected something that verifies a
+ * claim — checks a signature, confirms an output matches a schema. This is
+ * a rule engine that decides, BEFORE a tool runs, whether the call is
+ * permitted: allow / deny / review, by name, category, tier or a pattern
+ * over the arguments. Every rule variant says so.
+ *
+ * The misreading was not academic. The module sat beside real guardrail and
+ * HITL neighbours, where "verification" actively suggests the post-hoc
+ * double-check the guardrails do.
+ */
+/**
+ * The two schemas below carry aliases too, and the task that specified this
+ * rename said they would not need any: `public-runtime.ts` records that they
+ * are deliberately not re-exported, so they looked unreachable.
+ *
+ * They were not. `public-types.ts` re-exports this module with
+ * `export type *`, which exports every name in TYPE position — including a
+ * `const`. So `import type { VerificationRuleSchema } from '@namzu/sdk'`
+ * compiled and `typeof VerificationRuleSchema` was a usable type, while
+ * importing it as a value failed with TS1362. Checked by compiling both
+ * forms against the built package rather than reading the barrel.
+ *
+ * Declared as `const` rather than `type` on purpose: a `type` alias would
+ * break `typeof`, which is the only way these were ever usable.
+ */
+//# sourceMappingURL=index.js.map

package/dist/types/authorization/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/authorization/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAA;AAsFlF,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC;IAClC,uEAAuE;IACvE,yEAAyE;IACzE,2EAA2E;IAC3E,yEAAyE;IACzE,2EAA2E;IAC3E,iCAAiC;IACjC,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAA;AACF,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAA;AAC5F,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC;IACpC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC/B,CAAC,CAAA;AACF,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;IAChC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC9B,CAAC,CAAA;AACF,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;IAC/B,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC9B,CAAC,CAAA;AACF,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,yBAAyB,CAAC;IAClD,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC,CAAA;AACF,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;IACnC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,2EAA2E;IAC3E,mDAAmD;IACnD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,yBAAyB,CAAC;IAClD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC,CAAA;AACF,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC1B,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACnE,mBAAmB;IACnB,2BAA2B;IAC3B,qBAAqB;IACrB,iBAAiB;IACjB,gBAAgB;IAChB,mBAAmB;IACnB,qBAAqB;IACrB,iBAAiB;CACjB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACnD,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAC9C;;;;;;;OAOG;IACH,8BAA8B,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC9D,qBAAqB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACjD,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACvC,CAAC,CAAA;AAIF;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;;;;;;GAcG"}

package/dist/types/bus/index.d.ts

@@ -22,7 +22,7 @@ export type LockAcquireResult = {
     lock: FileLock;
 } | {
     acquired: false;
-    holder: RunId;
+    holder?: RunId;
     filePath: string;
 };
 export interface FileOwnership {
@@ -121,6 +121,29 @@ export type AgentBusEvent = {
     runId?: RunId;
     durationMs: number;
     error: string;
+}
+/**
+ * A credential was written, removed, or replaced.
+ *
+ * Rotation was invisible: a lapsed OAuth token was refreshed straight
+ * into a host's file store, and this union carried a LOOKUP event and no
+ * change event — so no probe subscriber could see a credential turn
+ * over, and nothing could answer "when did this last rotate".
+ *
+ * Carries no secret and never will. The whole value of a change event is
+ * that it can be logged, forwarded and retained, which is exactly what a
+ * credential must not be. `source` names where it lives; the value stays
+ * where it lives.
+ */
+ | {
+    type: 'vault_credential_changed';
+    /** `rotated` is a set that REPLACED a value, not a first write. */
+    kind: 'set' | 'unset' | 'rotated';
+    /** Which backing store changed — `env`, a file path's label, a KMS id. */
+    source: string;
+    ref: string;
+    tenantId?: TenantId;
+    runId?: RunId;
 } | {
     type: 'vault_lookup';
     vaultId: string;

package/dist/types/bus/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/bus/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/bus/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAEvF,YAAY,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE7C,MAAM,MAAM,cAAc,GAAG,SAAS,MAAM,EAAE,CAAA;AAE9C,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAA;AAEjE,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAA;IACnC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAA;IAC1B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,MAAM,iBAAiB,GAC1B;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAOlC;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AAExD,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,MAAM,oBAAoB,GAC7B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,aAAa,CAAA;CAAE,GAC3C;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,YAAY,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AAE5D,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,MAAM,CAAA;AAEpD,MAAM,MAAM,aAAa,GACtB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,KAAK,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,KAAK,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,KAAK,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,KAAK,CAAC;IAAC,YAAY,EAAE,KAAK,CAAA;CAAE,GACrF;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,UAAU,EAAE,KAAK,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,UAAU,EAAE,KAAK,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,UAAU,EAAE,KAAK,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,UAAU,EAAE,KAAK,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,UAAU,EAAE,KAAK,CAAA;CAAE,GACpD;IACA,IAAI,EAAE,qBAAqB,CAAA;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,cAAc,CAAA;IACtB,KAAK,CAAC,EAAE,KAAK,CAAA;CACZ,GACD;IACA,IAAI,EAAE,yBAAyB,CAAA;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,cAAc,CAAA;IACtB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,iBAAiB,CAAA;CACxB,GACD;IACA,IAAI,EAAE,sBAAsB,CAAA;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,cAAc,CAAA;IACtB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CACZ;AACH;;;;;;;;;;;;GAYG;GACD;IACA,IAAI,EAAE,0BAA0B,CAAA;IAChC,mEAAmE;IACnE,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,SAAS,CAAA;IACjC,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,KAAK,CAAC,EAAE,KAAK,CAAA;CACZ,GACD;IACA,IAAI,EAAE,cAAc,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,KAAK,CAAA;CACZ,GACD;IACA,IAAI,EAAE,kBAAkB,CAAA;IACxB,SAAS,EAAE,SAAS,CAAA;IACpB,MAAM,EAAE,qBAAqB,CAAA;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,KAAK,CAAA;CACZ,CAAA;AAEJ,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA"}

package/dist/types/code-navigation/index.d.ts

@@ -0,0 +1,112 @@
+/**
+ * The seam a language server arrives on.
+ *
+ * Declared in the SDK and implemented in `@namzu/lsp`, the same split
+ * `Sandbox` uses: the kernel owns the shape a tool programs against, and the
+ * optional package owns the process that answers. A host constructs one and
+ * puts it on the tool context — there is no `registerProvider()` discovery
+ * step, because a capability a host cannot see it wired up is one it cannot
+ * debug either.
+ *
+ * Kept here rather than imported from `@namzu/lsp` because the dependency
+ * direction forbids it: `sdk ← lsp`, never the other way. A duplicated
+ * declaration would be a second definition that can drift, so `@namzu/lsp`
+ * imports THESE types and implements them.
+ */
+/** A place in a file, zero-based, matching the language-server wire. */
+export interface SourceLocation {
+    /** Absolute path. Callers get back something they can open. */
+    readonly path: string;
+    readonly line: number;
+    readonly character: number;
+    readonly endLine?: number;
+    readonly endCharacter?: number;
+}
+/**
+ * What a navigation query answers.
+ *
+ * Three cases, closed, and the last two are separate on purpose.
+ * `unsupported` is "this server does not do that" — a caller can fall back
+ * to `grep` and say the answer is textual. `failed` is "something broke" —
+ * a caller must not present the absence of an answer as a complete one.
+ *
+ * Neither is `{ kind: 'locations', locations: [] }`. An empty list means "I
+ * looked, and there are none", which is a real answer and the one a
+ * deletion depends on; conflating it with a failure is how an agent
+ * concludes a symbol has no callers because the server never started.
+ */
+export type CodeNavigationResult = {
+    readonly kind: 'locations';
+    readonly locations: readonly SourceLocation[];
+} | {
+    readonly kind: 'unsupported';
+    readonly reason: string;
+} | {
+    readonly kind: 'failed';
+    readonly error: string;
+};
+/** A symbol found by name rather than by position. */
+export interface SymbolLocation extends SourceLocation {
+    readonly name: string;
+    /** The wire's own symbol-kind number, when the server gave one. */
+    readonly symbolKind?: number;
+    /** The class, module or namespace it sits in, when the server gave one. */
+    readonly containerName?: string;
+}
+/**
+ * What hovering over a position says.
+ *
+ * `contents` may be EMPTY, and that is a real answer: hovering over
+ * whitespace or a comment resolves to nothing, and a caller must be able to
+ * tell that from a server that failed. Same reason `locations: []` is not a
+ * failure.
+ */
+export type HoverResult = {
+    readonly kind: 'hover';
+    readonly contents: string;
+} | {
+    readonly kind: 'unsupported';
+    readonly reason: string;
+} | {
+    readonly kind: 'failed';
+    readonly error: string;
+};
+export type SymbolSearchResult = {
+    readonly kind: 'symbols';
+    readonly symbols: readonly SymbolLocation[];
+} | {
+    readonly kind: 'unsupported';
+    readonly reason: string;
+} | {
+    readonly kind: 'failed';
+    readonly error: string;
+};
+export interface CodeNavigationProvider {
+    /** Where the symbol under this position is declared. */
+    definition(file: string, line: number, character: number): Promise<CodeNavigationResult>;
+    /** Everywhere the symbol under this position is used. */
+    references(file: string, line: number, character: number): Promise<CodeNavigationResult>;
+    /** The symbol's type and documentation, without opening the file. */
+    hover(file: string, line: number, character: number): Promise<HoverResult>;
+    /**
+     * Find a declaration by NAME, with no position.
+     *
+     * The operation an agent reaches for first, and the one whose absence
+     * made the rest unreachable: `definition` and `references` both need a
+     * line and a character, and an agent starting from a name has neither.
+     * Without this, every navigation began with a grep — which is the text
+     * path this package exists to replace.
+     *
+     * `scope` is a file path or an extension that picks which language's
+     * server answers. Absent means every configured language.
+     */
+    symbols(query: string, scope?: string): Promise<SymbolSearchResult>;
+    /**
+     * Stop whatever backs it.
+     *
+     * Not optional. An implementation spawns a process, and a provider that
+     * could not be told to stop leaves one behind per run.
+     */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/code-navigation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/code-navigation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,oBAAoB,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAA;CAAE,GAC7E;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtD,sDAAsD;AACtD,MAAM,WAAW,cAAe,SAAQ,cAAc;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,mEAAmE;IACnE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtD,MAAM,MAAM,kBAAkB,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAA;CAAE,GACzE;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtD,MAAM,WAAW,sBAAsB;IACtC,wDAAwD;IACxD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;IACxF,yDAAyD;IACzD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;IACxF,qEAAqE;IACrE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IAC1E;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACnE;;;;;OAKG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB"}

package/dist/types/code-navigation/index.js

@@ -0,0 +1,17 @@
+/**
+ * The seam a language server arrives on.
+ *
+ * Declared in the SDK and implemented in `@namzu/lsp`, the same split
+ * `Sandbox` uses: the kernel owns the shape a tool programs against, and the
+ * optional package owns the process that answers. A host constructs one and
+ * puts it on the tool context — there is no `registerProvider()` discovery
+ * step, because a capability a host cannot see it wired up is one it cannot
+ * debug either.
+ *
+ * Kept here rather than imported from `@namzu/lsp` because the dependency
+ * direction forbids it: `sdk ← lsp`, never the other way. A duplicated
+ * declaration would be a second definition that can drift, so `@namzu/lsp`
+ * imports THESE types and implements them.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/code-navigation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/code-navigation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/dist/types/command/index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Commands a HOST offers its operator — not tools a model can call.
+ *
+ * There was no seam at all. The whole vocabulary was a literal array in one
+ * host's TUI module, over a union shaped by that TUI's own concerns
+ * (`repick`, `expand`, `login`, `clear`), and the coupling had already
+ * escaped: two non-TUI commands import that array from React-adjacent code
+ * to build a name list, for facts the kernel owns.
+ *
+ * **Never model-visible.** No descriptor is handed to a provider, no
+ * dispatch path reaches the LLM, and nothing here is a `ToolDefinition`.
+ * That separation is the whole point: a `/tasks` readout is a question the
+ * operator asked, and turning it into a tool would let the model call it,
+ * spend a turn on it, and put its output in the transcript as if the model
+ * had discovered something.
+ */
+/**
+ * What a command produces, structured rather than rendered.
+ *
+ * The SDK formats nothing. A TUI draws a table, a JSON command prints a
+ * document, a web host renders a component — and a pre-rendered string
+ * would force all three to parse prose back into the fields it was built
+ * from. Returning the fields is the only shape that serves a host the
+ * kernel has never seen.
+ */
+export type HostCommandOutcome = {
+    readonly kind: 'report';
+    readonly title: string;
+    readonly rows: readonly HostCommandRow[];
+} | {
+    readonly kind: 'prompt';
+    readonly text: string;
+} | {
+    readonly kind: 'ack';
+    readonly message: string;
+}
+/**
+ * The command exists and cannot answer right now.
+ *
+ * Different from an empty `report`, and different from `undefined`. An
+ * empty report says "I looked and there are none"; this says "I could
+ * not look", and a host that conflates them shows an operator a
+ * confident zero for a question nobody answered.
+ */
+ | {
+    readonly kind: 'refused';
+    readonly reason: string;
+};
+/** One line of a report. Keys are column names; a host decides the order. */
+export type HostCommandRow = Readonly<Record<string, string | number | boolean | null>>;
+export interface HostCommandContext {
+    /** Whatever followed the command name, unparsed. */
+    readonly args: readonly string[];
+}
+/**
+ * A command as it is registered, handler included.
+ *
+ * `args` is JSON Schema rather than Zod, for the same reason
+ * `ToolDefinition.modelInputSchema` is: a descriptor has to survive being
+ * sent to a host that is not this process, and a Zod schema does not
+ * serialize.
+ */
+export interface HostCommandDescriptor {
+    readonly name: string;
+    readonly description: string;
+    /** One line a host can show beside the name. */
+    readonly hint?: string;
+    /** JSON Schema for the arguments, when the command takes any. */
+    readonly args?: Record<string, unknown>;
+    handler(ctx: HostCommandContext): Promise<HostCommandOutcome> | HostCommandOutcome;
+}
+/** The same descriptor with the handler removed, safe to serialize. */
+export type SerializableHostCommand = Omit<HostCommandDescriptor, 'handler'>;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/command/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/command/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,CAAA;CAAE,GAC7F;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AACpD;;;;;;;GAOG;GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAExD,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,CAAA;AAEvF,MAAM,WAAW,kBAAkB;IAClC,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAChC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,iEAAiE;IACjE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvC,OAAO,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,GAAG,kBAAkB,CAAA;CAClF;AAED,uEAAuE;AACvE,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAA"}

package/dist/types/command/index.js

@@ -0,0 +1,18 @@
+/**
+ * Commands a HOST offers its operator — not tools a model can call.
+ *
+ * There was no seam at all. The whole vocabulary was a literal array in one
+ * host's TUI module, over a union shaped by that TUI's own concerns
+ * (`repick`, `expand`, `login`, `clear`), and the coupling had already
+ * escaped: two non-TUI commands import that array from React-adjacent code
+ * to build a name list, for facts the kernel owns.
+ *
+ * **Never model-visible.** No descriptor is handed to a provider, no
+ * dispatch path reaches the LLM, and nothing here is a `ToolDefinition`.
+ * That separation is the whole point: a `/tasks` readout is a question the
+ * operator asked, and turning it into a tool would let the model call it,
+ * spend a turn on it, and put its output in the transcript as if the model
+ * had discovered something.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/command/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/command/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/types/common/index.d.ts

@@ -1,5 +1,14 @@
-export type AgentStatus = 'idle' | 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
-export declare function isTerminalStatus(status: AgentStatus): boolean;
+/**
+ * The lifecycle of one RUN.
+ *
+ * Named for what it types. Every one of its uses in this package is a
+ * run's status, a run's audit outcome, or the status field of a run's
+ * result -- none of them describe an `AbstractAgent` or a
+ * `ReactiveAgent`, which have no status of their own. The old name sent a
+ * reader looking for an agent's lifecycle to the type that governs a run.
+ */
+export type RunExecutionStatus = 'idle' | 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+export declare function isTerminalStatus(status: RunExecutionStatus): boolean;
 export interface TokenUsage {
     promptTokens: number;
     completionTokens: number;

package/dist/types/common/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/common/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAA;AAE/F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAE7D;AAED,MAAM,WAAW,UAAU;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;IAExB;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GAAG,UAAU,CAe1F;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,GAAG,UAAU,CAoBjF;AAED,MAAM,WAAW,QAAQ;IACxB;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB;;;;;;;;;;;;;;;;;;OAkBG;IACH,cAAc,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,SAAS,EAAE,OAAO,CAAA;CAClB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAC3B,MAAM,GACN,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,CAAA;AAEd,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAEpE;AAED,MAAM,WAAW,UAAU;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;IAExB;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GAAG,UAAU,CAe1F;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,GAAG,UAAU,CAoBjF;AAED,MAAM,WAAW,QAAQ;IACxB;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB;;;;;;;;;;;;;;;;;;OAkBG;IACH,cAAc,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,SAAS,EAAE,OAAO,CAAA;CAClB"}

package/dist/types/common/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/common/index.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAAC,MAAmB;IACnD,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,WAAW,CAAA;AAC/E,CAAC;AAuBD,MAAM,UAAU,oBAAoB,CAAC,OAAmB,EAAE,QAAoB;IAC7E,OAAO;QACN,YAAY,EAAE,OAAO,CAAC,YAAY,GAAG,QAAQ,CAAC,YAAY;QAC1D,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,GAAG,QAAQ,CAAC,gBAAgB;QACtE,WAAW,EAAE,OAAO,CAAC,WAAW,GAAG,QAAQ,CAAC,WAAW;QACvD,YAAY,EAAE,OAAO,CAAC,YAAY,GAAG,QAAQ,CAAC,YAAY;QAC1D,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,GAAG,QAAQ,CAAC,gBAAgB;QACtE,qEAAqE;QACrE,uEAAuE;QACvE,sEAAsE;QACtE,2CAA2C;QAC3C,GAAG,CAAC,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,QAAQ,CAAC,eAAe,KAAK,SAAS;YAClF,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,OAAO,CAAC,eAAe,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,eAAe,IAAI,CAAC,CAAC,EAAE;YACvF,CAAC,CAAC,EAAE,CAAC;KACN,CAAA;AACF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,OAAmB,EAAE,IAAgB;IACpE,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;IACtE,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAA;IAElF,OAAO;QACN,YAAY;QACZ,gBAAgB;QAChB,uEAAuE;QACvE,oEAAoE;QACpE,uEAAuE;QACvE,kEAAkE;QAClE,sEAAsE;QACtE,mEAAmE;QACnE,iEAAiE;QACjE,kEAAkE;QAClE,uCAAuC;QACvC,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,YAAY,GAAG,gBAAgB,CAAC;QAC7F,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC;QAC/D,gBAAgB,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,CAAC;KAC3E,CAAA;AACF,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/common/index.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,gBAAgB,CAAC,MAA0B;IAC1D,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,WAAW,CAAA;AAC/E,CAAC;AAuBD,MAAM,UAAU,oBAAoB,CAAC,OAAmB,EAAE,QAAoB;IAC7E,OAAO;QACN,YAAY,EAAE,OAAO,CAAC,YAAY,GAAG,QAAQ,CAAC,YAAY;QAC1D,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,GAAG,QAAQ,CAAC,gBAAgB;QACtE,WAAW,EAAE,OAAO,CAAC,WAAW,GAAG,QAAQ,CAAC,WAAW;QACvD,YAAY,EAAE,OAAO,CAAC,YAAY,GAAG,QAAQ,CAAC,YAAY;QAC1D,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,GAAG,QAAQ,CAAC,gBAAgB;QACtE,qEAAqE;QACrE,uEAAuE;QACvE,sEAAsE;QACtE,2CAA2C;QAC3C,GAAG,CAAC,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,QAAQ,CAAC,eAAe,KAAK,SAAS;YAClF,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,OAAO,CAAC,eAAe,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,eAAe,IAAI,CAAC,CAAC,EAAE;YACvF,CAAC,CAAC,EAAE,CAAC;KACN,CAAA;AACF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,OAAmB,EAAE,IAAgB;IACpE,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;IACtE,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAA;IAElF,OAAO;QACN,YAAY;QACZ,gBAAgB;QAChB,uEAAuE;QACvE,oEAAoE;QACpE,uEAAuE;QACvE,kEAAkE;QAClE,sEAAsE;QACtE,mEAAmE;QACnE,iEAAiE;QACjE,kEAAkE;QAClE,uCAAuC;QACvC,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,YAAY,GAAG,gBAAgB,CAAC;QAC7F,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC;QAC/D,gBAAgB,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,CAAC;KAC3E,CAAA;AACF,CAAC"}