pulseed 0.6.4 → 0.6.6

package/dist/tools/tool-definition-adapter.js

@@ -1,29 +1,198 @@
 import { zodToJsonSchema } from "zod-to-json-schema";
-/**
- * Convert a single ITool instance to a ToolDefinition (JSON schema format)
- * that the LLM client understands for function calling.
- */
-export function toToolDefinition(tool) {
-    const jsonSchema = zodToJsonSchema(tool.inputSchema, { target: "openApi3" });
-    // zodToJsonSchema may wrap in { $schema, ... } — extract the relevant parts
-    const parameters = {};
-    if (typeof jsonSchema === "object" && jsonSchema !== null) {
-        const schema = jsonSchema;
-        parameters.type = schema.type ?? "object";
-        if (schema.properties)
-            parameters.properties = schema.properties;
-        if (schema.required)
-            parameters.required = schema.required;
-        if (schema.additionalProperties !== undefined) {
-            parameters.additionalProperties = schema.additionalProperties;
+function isJsonObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function normalizeSchemaNode(value) {
+    if (Array.isArray(value)) {
+        return value.map(normalizeSchemaNode);
+    }
+    if (!isJsonObject(value)) {
+        return value;
+    }
+    const normalized = {};
+    for (const [key, child] of Object.entries(value)) {
+        if (key === "$schema")
+            continue;
+        if (isSchemaNameMapKey(key) && isJsonObject(child)) {
+            normalized[key] = normalizeSchemaNameMap(child);
+            continue;
         }
+        normalized[key] = normalizeSchemaNode(child);
+    }
+    removeWeakerInclusiveBoundary(normalized, "minimum", "exclusiveMinimum", (inclusive, exclusive) => inclusive <= exclusive);
+    removeWeakerInclusiveBoundary(normalized, "maximum", "exclusiveMaximum", (inclusive, exclusive) => inclusive >= exclusive);
+    normalizeConstLiteral(normalized);
+    return normalized;
+}
+function isSchemaNameMapKey(key) {
+    return key === "properties" || key === "patternProperties" || key === "$defs" || key === "definitions";
+}
+function normalizeSchemaNameMap(value) {
+    const normalized = {};
+    for (const [key, child] of Object.entries(value)) {
+        normalized[key] = normalizeSchemaNode(child);
+    }
+    return normalized;
+}
+function normalizeConstLiteral(schema) {
+    if (!Object.hasOwn(schema, "const") || schema.enum !== undefined)
+        return;
+    schema.enum = [schema.const];
+    delete schema.const;
+}
+function removeWeakerInclusiveBoundary(schema, inclusiveKey, exclusiveKey, isWeakerOrEqual) {
+    const inclusive = schema[inclusiveKey];
+    const exclusive = schema[exclusiveKey];
+    if (typeof inclusive === "number" &&
+        Number.isFinite(inclusive) &&
+        typeof exclusive === "number" &&
+        Number.isFinite(exclusive) &&
+        isWeakerOrEqual(inclusive, exclusive)) {
+        delete schema[inclusiveKey];
+    }
+}
+function toolParametersFromSchema(jsonSchema) {
+    const normalizedSchema = normalizeSchemaNode(jsonSchema);
+    if (!isJsonObject(normalizedSchema)) {
+        return {
+            type: "object",
+            properties: {},
+            required: [],
+        };
+    }
+    const parameters = { ...normalizedSchema };
+    parameters.type = parameters.type ?? "object";
+    const objectBranches = collectObjectBranches(parameters);
+    if (objectBranches !== null) {
+        parameters.properties = collectObjectBranchProperties(objectBranches.branches);
+        parameters.required = collectRequiredProperties(objectBranches.branches, objectBranches.requiredMode);
+        parameters.additionalProperties = objectBranches.branches.every((branch) => branch.additionalProperties === false)
+            ? false
+            : parameters.additionalProperties ?? false;
+        delete parameters.anyOf;
+        delete parameters.oneOf;
+        delete parameters.allOf;
     }
-    // Ensure we always have a valid object schema
-    if (!parameters.type) {
-        parameters.type = "object";
+    if (parameters.properties === undefined &&
+        parameters.anyOf === undefined &&
+        parameters.oneOf === undefined &&
+        parameters.allOf === undefined) {
         parameters.properties = {};
         parameters.required = [];
     }
+    return parameters;
+}
+function collectObjectBranches(schema) {
+    const branches = Array.isArray(schema.anyOf)
+        ? { values: schema.anyOf, requiredMode: "common" }
+        : Array.isArray(schema.oneOf)
+            ? { values: schema.oneOf, requiredMode: "common" }
+            : Array.isArray(schema.allOf)
+                ? { values: schema.allOf, requiredMode: "all" }
+                : null;
+    if (!branches || branches.values.length === 0)
+        return null;
+    const objectBranches = [];
+    for (const branch of branches.values) {
+        const objectBranch = collectObjectBranch(branch);
+        if (!objectBranch)
+            return null;
+        objectBranches.push(objectBranch);
+    }
+    return objectBranches.length > 0
+        ? { branches: objectBranches, requiredMode: branches.requiredMode }
+        : null;
+}
+function collectObjectBranch(value) {
+    if (!isJsonObject(value))
+        return null;
+    if (value.type === "object" && isJsonObject(value.properties))
+        return value;
+    const nested = collectObjectBranches(value);
+    if (!nested)
+        return null;
+    return {
+        type: "object",
+        properties: collectObjectBranchProperties(nested.branches),
+        required: collectRequiredProperties(nested.branches, nested.requiredMode),
+        additionalProperties: nested.branches.every((branch) => branch.additionalProperties === false)
+            ? false
+            : value.additionalProperties ?? false,
+    };
+}
+function collectObjectBranchProperties(branches) {
+    const merged = {};
+    for (const branch of branches) {
+        if (!isJsonObject(branch.properties))
+            continue;
+        for (const [key, value] of Object.entries(branch.properties)) {
+            const existing = merged[key];
+            merged[key] = existing === undefined ? value : mergePropertySchema(existing, value);
+        }
+    }
+    return merged;
+}
+function collectCommonRequiredProperties(branches) {
+    const requiredSets = branches.map((branch) => (Array.isArray(branch.required)
+        ? new Set(branch.required.filter((item) => typeof item === "string"))
+        : new Set()));
+    if (requiredSets.length === 0)
+        return [];
+    const [first, ...rest] = requiredSets;
+    return [...first].filter((item) => rest.every((set) => set.has(item)));
+}
+function collectAllRequiredProperties(branches) {
+    const required = new Set();
+    for (const branch of branches) {
+        if (!Array.isArray(branch.required))
+            continue;
+        for (const item of branch.required) {
+            if (typeof item === "string")
+                required.add(item);
+        }
+    }
+    return [...required];
+}
+function collectRequiredProperties(branches, mode) {
+    return mode === "all"
+        ? collectAllRequiredProperties(branches)
+        : collectCommonRequiredProperties(branches);
+}
+function mergePropertySchema(left, right) {
+    if (JSON.stringify(left) === JSON.stringify(right))
+        return left;
+    if (!isJsonObject(left) || !isJsonObject(right))
+        return {};
+    if (isRefOnlySchema(left))
+        return right;
+    if (isRefOnlySchema(right))
+        return left;
+    const leftEnum = enumValues(left);
+    const rightEnum = enumValues(right);
+    if (left.type === right.type && leftEnum && rightEnum) {
+        return {
+            type: left.type,
+            enum: [...new Set([...leftEnum, ...rightEnum])],
+        };
+    }
+    return {};
+}
+function isRefOnlySchema(value) {
+    return typeof value.$ref === "string" && Object.keys(value).length === 1;
+}
+function enumValues(value) {
+    if (!Array.isArray(value.enum))
+        return null;
+    const values = value.enum.filter((item) => typeof item === "string");
+    return values.length === value.enum.length ? values : null;
+}
+/**
+ * Convert a single ITool instance to a ToolDefinition (JSON schema format)
+ * that the LLM client understands for function calling.
+ */
+export function toToolDefinition(tool) {
+    const jsonSchema = zodToJsonSchema(tool.inputSchema, { target: "jsonSchema7", $refStrategy: "none" });
+    const parameters = toolParametersFromSchema(jsonSchema);
     return {
         type: "function",
         function: {

package/dist/tools/tool-definition-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-definition-adapter.js","sourceRoot":"","sources":["../../src/tools/tool-definition-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAIrD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAW;IAC1C,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAC7E,4EAA4E;IAC5E,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,UAAqC,CAAC;QACrD,UAAU,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,QAAQ,CAAC;QAC1C,IAAI,MAAM,CAAC,UAAU;YAAE,UAAU,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACjE,IAAI,MAAM,CAAC,QAAQ;YAAE,UAAU,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAC3D,IAAI,MAAM,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;YAC9C,UAAU,CAAC,oBAAoB,GAAG,MAAM,CAAC,oBAAoB,CAAC;QAChE,CAAC;IACH,CAAC;IACD,8CAA8C;IAC9C,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACrB,UAAU,CAAC,IAAI,GAAG,QAAQ,CAAC;QAC3B,UAAU,CAAC,UAAU,GAAG,EAAE,CAAC;QAC3B,UAAU,CAAC,QAAQ,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;YACxB,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;YAC/B,UAAU;SACX;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAc,EACd,OAA0C;IAE1C,MAAM,SAAS,GAAG,OAAO,EAAE,cAAc,IAAI,IAAI,GAAG,EAAU,CAAC;IAC/D,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAC1F,CAAC;IACF,OAAO,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACxC,CAAC"}
+{"version":3,"file":"tool-definition-adapter.js","sourceRoot":"","sources":["../../src/tools/tool-definition-adapter.ts"],"names":[],"mappings":"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"}

package/dist/tools/types.d.ts

@@ -1,6 +1,8 @@
 import { z } from "zod";
 import type { ExecutionPolicy, SubagentRole } from "../orchestrator/execution/agent-loop/execution-policy.js";
-import type { HostToolExecutionDecision } from "./execution-orchestrator.js";
+import type { PermissionGrantRecord } from "../runtime/store/permission-grant-store.js";
+import type { PermissionWaitCanonicalPlan, PermissionWaitPlanStore } from "../runtime/store/permission-wait-plan-store.js";
+import type { CapabilityAuditRecord, CapabilityOperationKind, CapabilityRiskClass, CapabilitySideEffectProfile, CapabilityVerificationRef } from "../runtime/store/capability-verification-schemas.js";
 export declare const ToolExecutionReasonSchema: z.ZodEnum<["approval_denied", "permission_denied", "policy_blocked", "dry_run", "tool_error", "timed_out", "interrupted", "sandbox_required", "escalation_required", "stale_state"]>;
 export declare const ToolResultSchema: z.ZodObject<{
     /** Whether the tool invocation succeeded */
@@ -54,13 +56,13 @@ export declare const ToolResultSchema: z.ZodObject<{
     durationMs: number;
     error?: string | undefined;
     data?: unknown;
+    artifacts?: string[] | undefined;
     execution?: {
         status: "executed" | "not_executed";
         message?: string | undefined;
         reason?: "timed_out" | "interrupted" | "approval_denied" | "permission_denied" | "policy_blocked" | "dry_run" | "tool_error" | "sandbox_required" | "escalation_required" | "stale_state" | undefined;
     } | undefined;
     contextModifier?: string | undefined;
-    artifacts?: string[] | undefined;
     truncated?: {
         originalChars: number;
         overflowPath?: string | undefined;
@@ -71,23 +73,33 @@ export declare const ToolResultSchema: z.ZodObject<{
     durationMs: number;
     error?: string | undefined;
     data?: unknown;
+    artifacts?: string[] | undefined;
     execution?: {
         status: "executed" | "not_executed";
         message?: string | undefined;
         reason?: "timed_out" | "interrupted" | "approval_denied" | "permission_denied" | "policy_blocked" | "dry_run" | "tool_error" | "sandbox_required" | "escalation_required" | "stale_state" | undefined;
     } | undefined;
     contextModifier?: string | undefined;
-    artifacts?: string[] | undefined;
     truncated?: {
         originalChars: number;
         overflowPath?: string | undefined;
     } | undefined;
 }>;
 export type ToolResult = z.infer<typeof ToolResultSchema>;
+export type HostToolExecutionDecisionStatus = "allowed" | "denied" | "needs_permission" | "needs_sandbox" | "needs_escalation" | "fail_closed";
+export interface HostToolExecutionDecision {
+    status: HostToolExecutionDecisionStatus;
+    reason: string;
+    executionReason?: NonNullable<ToolResult["execution"]>["reason"];
+    requiredSandboxMode?: "workspace_write" | "danger_full_access";
+    requiredApprovalPolicy?: "on_request";
+}
 export declare const ToolPermissionLevelSchema: z.ZodEnum<["read_only", "read_metrics", "write_local", "execute", "write_remote"]>;
 export type ToolPermissionLevel = z.infer<typeof ToolPermissionLevelSchema>;
 export declare const ToolActivityCategorySchema: z.ZodEnum<["search", "read", "planning", "command", "file_create", "file_modify", "test", "approval"]>;
 export type ToolActivityCategory = z.infer<typeof ToolActivityCategorySchema>;
+export declare const GatewayToolExposureSchema: z.ZodEnum<["default_safe", "approval_required", "runtime_control", "never"]>;
+export type GatewayToolExposure = z.infer<typeof GatewayToolExposureSchema>;
 export declare const ToolMetadataSchema: z.ZodObject<{
     /** Unique tool name (e.g., "glob", "shell") */
     name: z.ZodString;
@@ -125,11 +137,16 @@ export declare const ToolMetadataSchema: z.ZodObject<{
      * semantics from tool names.
      */
     activityCategory: z.ZodOptional<z.ZodEnum<["search", "read", "planning", "command", "file_create", "file_modify", "test", "approval"]>>;
+    /**
+     * Explicit gateway exposure policy. Read-only is necessary but not sufficient
+     * for external chat surfaces; tools must opt into the gateway catalog.
+     */
+    gatewayExposure: z.ZodOptional<z.ZodEnum<["default_safe", "approval_required", "runtime_control", "never"]>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     tags: string[];
     aliases: string[];
-    permissionLevel: "read_only" | "read_metrics" | "write_local" | "execute" | "write_remote";
+    permissionLevel: "execute" | "write_remote" | "read_only" | "read_metrics" | "write_local";
     isReadOnly: boolean;
     isDestructive: boolean;
     shouldDefer: boolean;
@@ -137,10 +154,11 @@ export declare const ToolMetadataSchema: z.ZodObject<{
     maxConcurrency: number;
     maxOutputChars: number;
     requiresNetwork?: boolean | undefined;
-    activityCategory?: "read" | "command" | "approval" | "search" | "planning" | "file_create" | "file_modify" | "test" | undefined;
+    activityCategory?: "read" | "search" | "command" | "approval" | "planning" | "file_create" | "file_modify" | "test" | undefined;
+    gatewayExposure?: "never" | "approval_required" | "runtime_control" | "default_safe" | undefined;
 }, {
     name: string;
-    permissionLevel: "read_only" | "read_metrics" | "write_local" | "execute" | "write_remote";
+    permissionLevel: "execute" | "write_remote" | "read_only" | "read_metrics" | "write_local";
     isReadOnly: boolean;
     isDestructive: boolean;
     tags?: string[] | undefined;
@@ -150,7 +168,8 @@ export declare const ToolMetadataSchema: z.ZodObject<{
     maxConcurrency?: number | undefined;
     maxOutputChars?: number | undefined;
     requiresNetwork?: boolean | undefined;
-    activityCategory?: "read" | "command" | "approval" | "search" | "planning" | "file_create" | "file_modify" | "test" | undefined;
+    activityCategory?: "read" | "search" | "command" | "approval" | "planning" | "file_create" | "file_modify" | "test" | undefined;
+    gatewayExposure?: "never" | "approval_required" | "runtime_control" | "default_safe" | undefined;
 }>;
 export type ToolMetadata = z.infer<typeof ToolMetadataSchema>;
 /**
@@ -198,11 +217,43 @@ export interface ToolDescriptionContext {
     /** Available data sources */
     dataSources?: string[];
 }
+export interface CapabilityExecutionContext {
+    operationId?: string;
+    providerRef?: string;
+    assetRef?: string;
+    capabilityId?: string;
+    operationKind?: CapabilityOperationKind;
+    toolName?: string;
+    payloadClass?: string;
+    riskClass?: CapabilityRiskClass;
+    sideEffectProfile?: CapabilitySideEffectProfile;
+    userDirected?: boolean;
+    initiatedBy?: string;
+    sourceSurface?: string;
+    readinessSnapshotRefs?: string[];
+    autonomyDecisionRef?: string;
+    approvalRefs?: string[];
+    executionRefs?: string[];
+    userVisibleEffect?: string;
+    sideEffectSummary?: string;
+}
+export interface CapabilityExecutionResolutionInput {
+    toolName: string;
+    toolMetadata: ToolMetadata;
+    rawInput: unknown;
+    operationKind: CapabilityOperationKind;
+    payloadClass: string;
+    riskClass: CapabilityRiskClass;
+    sideEffectProfile: CapabilitySideEffectProfile;
+}
+export type CapabilityExecutionResolver = (input: CapabilityExecutionResolutionInput) => CapabilityExecutionContext | null | Promise<CapabilityExecutionContext | null>;
 export interface ToolCallContext {
     /** Current working directory */
     cwd: string;
     /** Goal ID for trust/permission lookups */
     goalId: string;
+    /** Owning task ID when a tool runs inside a task-scoped agent loop. */
+    taskId?: string;
     /** Trust balance for the current context */
     trustBalance: number;
     /** Whether the user has pre-approved certain operations */
@@ -222,6 +273,31 @@ export interface ToolCallContext {
         currentEpoch: string;
         observedEpoch?: string;
     };
+    /** Optional durable run identifier for scope-bound permission grants. */
+    runId?: string;
+    /** Optional turn identifier for scope-bound permission grants. */
+    turnId?: string;
+    /** Optional project identifier for scope-bound permission grants. */
+    projectId?: string;
+    /** Durable permission grants available to the host/tool permission path. */
+    permissionGrantStore?: {
+        list(): Promise<PermissionGrantRecord[]>;
+        recordUse(grantId: string, input?: {
+            used_at?: number;
+            audit_ref?: string;
+        }): Promise<PermissionGrantRecord | null>;
+    };
+    /** Durable canonical plans for approval-gated tool calls. */
+    permissionWaitPlanStore?: Pick<PermissionWaitPlanStore, "createWaiting" | "markApproved" | "markDenied" | "markExpired" | "resumeApproved">;
+    /** Durable operation evidence store for capability runtime production executions. */
+    capabilityVerificationStore?: {
+        saveVerification(record: CapabilityVerificationRef): Promise<CapabilityVerificationRef>;
+        saveAudit(record: CapabilityAuditRecord): Promise<CapabilityAuditRecord>;
+    };
+    /** Typed capability operation context supplied by production caller paths. */
+    capabilityExecution?: CapabilityExecutionContext;
+    /** Optional resolver that binds production tool calls to current capability operation contracts. */
+    capabilityExecutionResolver?: CapabilityExecutionResolver;
     /** Optional subagent role for delegated runs. */
     agentRole?: SubagentRole;
     /** Abort signal for cancellation */
@@ -274,26 +350,39 @@ export interface ApprovalRequest {
     isDestructive: boolean;
     reversibility: "reversible" | "irreversible" | "unknown";
     callId?: string;
+    sessionId?: string;
+    runId?: string;
+    turnId?: string;
+    approvalId?: string;
+    permissionWaitPlanId?: string;
+    canonicalPermissionPlan?: PermissionWaitCanonicalPlan;
+    permissionGrantDecision?: unknown;
 }
 export declare const PermissionCheckResultSchema: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
     status: z.ZodLiteral<"allowed">;
+    permissionGrantDecision: z.ZodOptional<z.ZodUnknown>;
 }, "strip", z.ZodTypeAny, {
     status: "allowed";
+    permissionGrantDecision?: unknown;
 }, {
     status: "allowed";
+    permissionGrantDecision?: unknown;
 }>, z.ZodObject<{
     status: z.ZodLiteral<"denied">;
     reason: z.ZodString;
     executionReason: z.ZodOptional<z.ZodEnum<["approval_denied", "permission_denied", "policy_blocked", "dry_run", "tool_error", "timed_out", "interrupted", "sandbox_required", "escalation_required", "stale_state"]>>;
     policyDecision: z.ZodOptional<z.ZodUnknown>;
+    permissionGrantDecision: z.ZodOptional<z.ZodUnknown>;
 }, "strip", z.ZodTypeAny, {
     status: "denied";
     reason: string;
+    permissionGrantDecision?: unknown;
     executionReason?: "timed_out" | "interrupted" | "approval_denied" | "permission_denied" | "policy_blocked" | "dry_run" | "tool_error" | "sandbox_required" | "escalation_required" | "stale_state" | undefined;
     policyDecision?: unknown;
 }, {
     status: "denied";
     reason: string;
+    permissionGrantDecision?: unknown;
     executionReason?: "timed_out" | "interrupted" | "approval_denied" | "permission_denied" | "policy_blocked" | "dry_run" | "tool_error" | "sandbox_required" | "escalation_required" | "stale_state" | undefined;
     policyDecision?: unknown;
 }>, z.ZodObject<{
@@ -301,18 +390,22 @@ export declare const PermissionCheckResultSchema: z.ZodDiscriminatedUnion<"statu
     reason: z.ZodString;
     executionReason: z.ZodOptional<z.ZodEnum<["approval_denied", "permission_denied", "policy_blocked", "dry_run", "tool_error", "timed_out", "interrupted", "sandbox_required", "escalation_required", "stale_state"]>>;
     policyDecision: z.ZodOptional<z.ZodUnknown>;
+    permissionGrantDecision: z.ZodOptional<z.ZodUnknown>;
 }, "strip", z.ZodTypeAny, {
     status: "needs_approval";
     reason: string;
+    permissionGrantDecision?: unknown;
     executionReason?: "timed_out" | "interrupted" | "approval_denied" | "permission_denied" | "policy_blocked" | "dry_run" | "tool_error" | "sandbox_required" | "escalation_required" | "stale_state" | undefined;
     policyDecision?: unknown;
 }, {
     status: "needs_approval";
     reason: string;
+    permissionGrantDecision?: unknown;
     executionReason?: "timed_out" | "interrupted" | "approval_denied" | "permission_denied" | "policy_blocked" | "dry_run" | "tool_error" | "sandbox_required" | "escalation_required" | "stale_state" | undefined;
     policyDecision?: unknown;
 }>]>;
 export type PermissionCheckResult = z.infer<typeof PermissionCheckResultSchema> & {
     policyDecision?: HostToolExecutionDecision;
+    permissionGrantDecision?: unknown;
 };
 //# sourceMappingURL=types.d.ts.map

package/dist/tools/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"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"}

package/dist/tools/types.js

@@ -1,5 +1,10 @@
 import { z } from "zod";
 // --- Tool Result ---
+const NonNegativeSafeIntegerSchema = z.number()
+    .finite()
+    .int()
+    .nonnegative()
+    .max(Number.MAX_SAFE_INTEGER);
 export const ToolExecutionReasonSchema = z.enum([
     "approval_denied",
     "permission_denied",
@@ -31,7 +36,7 @@ export const ToolResultSchema = z.object({
         message: z.string().optional(),
     }).optional(),
     /** Duration of the tool call in milliseconds */
-    durationMs: z.number(),
+    durationMs: NonNegativeSafeIntegerSchema,
     /** Optional context modifier: instructions to append to subsequent LLM context */
     contextModifier: z.string().optional(),
     /**
@@ -41,7 +46,7 @@ export const ToolResultSchema = z.object({
     artifacts: z.array(z.string()).optional(),
     /** Set when output was truncated; contains the original character count */
     truncated: z.object({
-        originalChars: z.number(),
+        originalChars: NonNegativeSafeIntegerSchema,
         overflowPath: z.string().optional()
     }).optional(),
 });
@@ -64,12 +69,18 @@ export const ToolActivityCategorySchema = z.enum([
     "test",
     "approval",
 ]);
+export const GatewayToolExposureSchema = z.enum([
+    "default_safe",
+    "approval_required",
+    "runtime_control",
+    "never",
+]);
 // --- Tool Metadata ---
 export const ToolMetadataSchema = z.object({
     /** Unique tool name (e.g., "glob", "shell") */
-    name: z.string(),
+    name: z.string().min(1),
     /** Alternative names for discovery */
-    aliases: z.array(z.string()).default([]),
+    aliases: z.array(z.string().min(1)).default([]),
     /** Permission level */
     permissionLevel: ToolPermissionLevelSchema,
     /** Whether this tool is read-only (no side effects) */
@@ -86,14 +97,14 @@ export const ToolMetadataSchema = z.object({
     /** Whether this tool should always be loaded into context */
     alwaysLoad: z.boolean().default(false),
     /** Maximum concurrent invocations (0 = unlimited) */
-    maxConcurrency: z.number().default(0),
+    maxConcurrency: z.number().finite().int().nonnegative().max(Number.MAX_SAFE_INTEGER).default(0),
     /** Maximum characters of tool output to pass to LLM (excess persisted to disk) */
-    maxOutputChars: z.number().default(8000),
+    maxOutputChars: z.number().finite().int().positive().max(Number.MAX_SAFE_INTEGER).default(8000),
     /**
      * Tags for categorization and filtering.
      * Used by the context-filtered tier of the registry.
      */
-    tags: z.array(z.string()).default([]),
+    tags: z.array(z.string().min(1)).default([]),
     /** Whether this tool requires network access even if it is otherwise read-only. */
     requiresNetwork: z.boolean().optional(),
     /**
@@ -102,20 +113,27 @@ export const ToolMetadataSchema = z.object({
      * semantics from tool names.
      */
     activityCategory: ToolActivityCategorySchema.optional(),
+    /**
+     * Explicit gateway exposure policy. Read-only is necessary but not sufficient
+     * for external chat surfaces; tools must opt into the gateway catalog.
+     */
+    gatewayExposure: GatewayToolExposureSchema.optional(),
 });
 export const PermissionCheckResultSchema = z.discriminatedUnion("status", [
-    z.object({ status: z.literal("allowed") }),
+    z.object({ status: z.literal("allowed"), permissionGrantDecision: z.unknown().optional() }),
     z.object({
         status: z.literal("denied"),
         reason: z.string(),
         executionReason: ToolExecutionReasonSchema.optional(),
         policyDecision: z.unknown().optional(),
+        permissionGrantDecision: z.unknown().optional(),
     }),
     z.object({
         status: z.literal("needs_approval"),
         reason: z.string(),
         executionReason: ToolExecutionReasonSchema.optional(),
         policyDecision: z.unknown().optional(),
+        permissionGrantDecision: z.unknown().optional(),
     }),
 ]);
 //# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"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"}