@greppleai/grip 0.0.0-stage → 0.0.1

package/dist/core/hooks/types.d.ts

@@ -0,0 +1,234 @@
+import type { ToolOperations } from "../tools/operations.ts";
+export declare const HOOK_EVENT_NAMES: readonly ["SessionStart", "UserPromptSubmit", "PreToolUse", "PostToolUse", "PostToolUseFailure", "Stop", "StopFailure", "PreCompact", "PostCompact", "SessionEnd"];
+export declare const HOOK_EXECUTION_CUSTOM_TYPE = "hook_execution";
+export type HookEventName = (typeof HOOK_EVENT_NAMES)[number];
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export type PermissionMode = "default" | "plan" | "acceptEdits" | "auto" | "dontAsk" | "bypassPermissions";
+export type HookEffortLevel = "low" | "medium" | "high" | "xhigh" | "max";
+export interface HookEffort {
+    level: HookEffortLevel;
+}
+export type SessionStartHookSource = "startup" | "resume" | "clear" | "compact" | "fork";
+export type CompactionHookTrigger = "manual" | "auto";
+export interface HookInputCommon {
+    session_id: string;
+    transcript_path: string;
+    cwd: string;
+    hook_event_name: HookEventName;
+    prompt_id?: string;
+    permission_mode?: PermissionMode;
+    agent_id?: string;
+    agent_type?: string;
+    effort?: HookEffort;
+}
+export interface SessionStartHookInput extends HookInputCommon {
+    hook_event_name: "SessionStart";
+    source: SessionStartHookSource;
+    model?: string;
+    session_title?: string;
+}
+export interface UserPromptSubmitHookInput extends HookInputCommon {
+    hook_event_name: "UserPromptSubmit";
+    prompt: string;
+}
+export interface ToolHookInput extends HookInputCommon {
+    tool_name: string;
+    tool_input: JsonObject;
+    tool_use_id: string;
+}
+export interface PreToolUseHookInput extends ToolHookInput {
+    hook_event_name: "PreToolUse";
+}
+export interface PostToolUseHookInput extends ToolHookInput {
+    hook_event_name: "PostToolUse";
+    tool_response: JsonValue;
+    duration_ms?: number;
+}
+export interface PostToolUseFailureHookInput extends ToolHookInput {
+    hook_event_name: "PostToolUseFailure";
+    error: string;
+    is_interrupt?: boolean;
+    duration_ms?: number;
+}
+export interface StopHookInput extends HookInputCommon {
+    hook_event_name: "Stop";
+    stop_hook_active: boolean;
+    last_assistant_message: string;
+    background_tasks?: JsonObject[];
+    session_crons?: JsonObject[];
+}
+export interface StopFailureHookInput extends HookInputCommon {
+    hook_event_name: "StopFailure";
+    error: string;
+    error_details?: string;
+    last_assistant_message?: string;
+}
+export interface PreCompactHookInput extends HookInputCommon {
+    hook_event_name: "PreCompact";
+    trigger: CompactionHookTrigger;
+    custom_instructions: string;
+}
+export interface PostCompactHookInput extends HookInputCommon {
+    hook_event_name: "PostCompact";
+    trigger: CompactionHookTrigger;
+    compact_summary: string;
+}
+export type SessionEndReason = "clear" | "resume" | "logout" | "prompt_input_exit" | "other";
+export interface SessionEndHookInput extends HookInputCommon {
+    hook_event_name: "SessionEnd";
+    reason: SessionEndReason;
+}
+export type HookInput = SessionStartHookInput | UserPromptSubmitHookInput | PreToolUseHookInput | PostToolUseHookInput | PostToolUseFailureHookInput | StopHookInput | StopFailureHookInput | PreCompactHookInput | PostCompactHookInput | SessionEndHookInput;
+export type HookCommandShell = "bash" | "powershell";
+export type UnsupportedHookHandlerType = "prompt" | "agent" | "mcp_tool";
+export interface HookHandlerCommon {
+    timeout?: number;
+    if?: string;
+    statusMessage?: string;
+}
+export interface CommandHookHandler extends HookHandlerCommon {
+    type: "command";
+    command: string;
+    args?: string[];
+    shell?: HookCommandShell;
+}
+export interface HttpHookHandler extends HookHandlerCommon {
+    type: "http";
+    url: string;
+    headers?: Record<string, string>;
+    allowedEnvVars?: string[];
+}
+export interface UnsupportedHookHandler extends HookHandlerCommon {
+    type: UnsupportedHookHandlerType;
+}
+export type HookHandler = CommandHookHandler | HttpHookHandler | UnsupportedHookHandler;
+export interface HookGroup {
+    matcher?: string;
+    hooks: HookHandler[];
+}
+export type HookConfiguration = Partial<Record<HookEventName, HookGroup[]>>;
+export type HookSettingsSourceKind = "user" | "project" | "local" | "host";
+export interface HookSettingsSource {
+    kind: HookSettingsSourceKind;
+    path: string;
+}
+export type HookDiagnosticCode = "read" | "parse" | "schema" | "unsupported-handler" | "invalid-regex" | "execution" | "policy" | "malformed-output" | "system-message" | "unsupported-update" | "continuation-cap";
+export type HookDiagnosticLevel = "warning" | "error";
+export interface HookDiagnostic {
+    level: HookDiagnosticLevel;
+    code: HookDiagnosticCode;
+    message: string;
+    source?: HookSettingsSource;
+    event?: HookEventName;
+}
+export interface LoadedHookHandler {
+    event: HookEventName;
+    matcher?: string;
+    handler: HookHandler;
+    source: HookSettingsSource;
+    order: number;
+    /** Effective settings-policy environment allowlist for this HTTP hook. */
+    httpHookAllowedEnvVars?: readonly string[];
+}
+export interface LoadedHooks {
+    readonly handlers: readonly LoadedHookHandler[];
+    readonly diagnostics: readonly HookDiagnostic[];
+    readonly sources: readonly HookSettingsSource[];
+}
+export interface HookStructuredOutput {
+    continue?: boolean;
+    stopReason?: string;
+    suppressOutput?: boolean;
+    systemMessage?: string;
+    terminalSequence?: string;
+    decision?: string;
+    reason?: string;
+    hookSpecificOutput?: JsonObject;
+}
+export type HookOutputClassification = {
+    kind: "empty";
+} | {
+    kind: "text";
+    text: string;
+    malformedJson: boolean;
+} | {
+    kind: "json";
+    value: HookStructuredOutput;
+};
+export type HookExecutionStatus = "completed" | "timeout" | "cancelled" | "error" | "unsupported";
+export interface HookExecutionResult {
+    hook: LoadedHookHandler;
+    status: HookExecutionStatus;
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    stdoutTruncated: boolean;
+    stderrTruncated: boolean;
+    output: HookOutputClassification;
+    blocking: boolean;
+    blockingReason?: string;
+    durationMs: number;
+    diagnostic?: HookDiagnostic;
+}
+export interface HookRunOptions {
+    /** Active workspace backend used for project/local hook isolation. */
+    toolOperations?: Pick<ToolOperations, "cwd" | "exec" | "getBackendInfo">;
+    signal?: AbortSignal;
+    env?: NodeJS.ProcessEnv;
+    maxOutputBytes?: number;
+    fetch?: typeof globalThis.fetch;
+    /** Internal/test platform override for process-tree termination behavior. */
+    platform?: NodeJS.Platform;
+    /** Internal/test override for Windows process-tree termination. Return false to request direct-child fallback. */
+    terminateWindowsProcessTree?: (pid: number) => boolean;
+    /** Shared timeout override (used for SessionEnd matching handlers). */
+    timeoutSeconds?: number;
+    /** Host ceiling for HTTP destinations. Omitted means no additional host restriction. */
+    allowedHttpHookUrls?: readonly string[];
+    /** Host ceiling for HTTP header environment interpolation. */
+    httpHookAllowedEnvVars?: readonly string[];
+}
+export type HookPermissionDecision = "allow" | "ask" | "defer" | "deny";
+export interface HookAggregateResult {
+    continue: boolean;
+    blocked: boolean;
+    reason?: string;
+    additionalContext: string[];
+    systemMessages: string[];
+    plainText: string[];
+    permissionDecision?: HookPermissionDecision;
+    updatedInput?: JsonObject;
+    updatedToolOutput?: JsonValue;
+    sessionTitle?: string;
+    initialUserMessage?: string;
+    /** Aggregate remaining-work metric reported by Stop hooks. Lower values indicate progress. */
+    stopContinuationProgress?: number;
+    reloadSkills?: boolean;
+    results: HookExecutionResult[];
+}
+/** Sanitized completed handler call for host UI rendering. */
+export interface HookExecutionCallNotice {
+    type: HookHandler["type"];
+    label: string;
+    source: HookSettingsSource;
+    status: HookExecutionStatus;
+    exitCode: number | null;
+    durationMs: number;
+}
+/** One completed hook event execution persisted as audit-only session data and exposed to host UI observers. */
+export interface HookExecutionNotice {
+    event: HookEventName;
+    subject?: string;
+    calls: HookExecutionCallNotice[];
+    returnedPrompts: string[];
+}
+export declare function parseHookExecutionNotice(value: unknown): HookExecutionNotice | undefined;
+export type HookExecutionListener = (notice: HookExecutionNotice) => void;
+export type HookExecutionActivityListener = (active: boolean) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/hooks/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/types.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ToolOperations } from \"../tools/operations.ts\";\n\nexport const HOOK_EVENT_NAMES = [\n\t\"SessionStart\",\n\t\"UserPromptSubmit\",\n\t\"PreToolUse\",\n\t\"PostToolUse\",\n\t\"PostToolUseFailure\",\n\t\"Stop\",\n\t\"StopFailure\",\n\t\"PreCompact\",\n\t\"PostCompact\",\n\t\"SessionEnd\",\n] as const;\nexport const HOOK_EXECUTION_CUSTOM_TYPE = \"hook_execution\";\n\nexport type HookEventName = (typeof HOOK_EVENT_NAMES)[number];\nexport type JsonPrimitive = string | number | boolean | null;\nexport type JsonValue = JsonPrimitive | JsonValue[] | { [key: string]: JsonValue };\nexport type JsonObject = { [key: string]: JsonValue };\n\nexport type PermissionMode = \"default\" | \"plan\" | \"acceptEdits\" | \"auto\" | \"dontAsk\" | \"bypassPermissions\";\nexport type HookEffortLevel = \"low\" | \"medium\" | \"high\" | \"xhigh\" | \"max\";\n\nexport interface HookEffort {\n\tlevel: HookEffortLevel;\n}\nexport type SessionStartHookSource = \"startup\" | \"resume\" | \"clear\" | \"compact\" | \"fork\";\nexport type CompactionHookTrigger = \"manual\" | \"auto\";\n\nexport interface HookInputCommon {\n\tsession_id: string;\n\ttranscript_path: string;\n\tcwd: string;\n\thook_event_name: HookEventName;\n\tprompt_id?: string;\n\tpermission_mode?: PermissionMode;\n\tagent_id?: string;\n\tagent_type?: string;\n\teffort?: HookEffort;\n}\n\nexport interface SessionStartHookInput extends HookInputCommon {\n\thook_event_name: \"SessionStart\";\n\tsource: SessionStartHookSource;\n\tmodel?: string;\n\tsession_title?: string;\n}\nexport interface UserPromptSubmitHookInput extends HookInputCommon {\n\thook_event_name: \"UserPromptSubmit\";\n\tprompt: string;\n}\nexport interface ToolHookInput extends HookInputCommon {\n\ttool_name: string;\n\ttool_input: JsonObject;\n\ttool_use_id: string;\n}\nexport interface PreToolUseHookInput extends ToolHookInput {\n\thook_event_name: \"PreToolUse\";\n}\nexport interface PostToolUseHookInput extends ToolHookInput {\n\thook_event_name: \"PostToolUse\";\n\ttool_response: JsonValue;\n\tduration_ms?: number;\n}\nexport interface PostToolUseFailureHookInput extends ToolHookInput {\n\thook_event_name: \"PostToolUseFailure\";\n\terror: string;\n\tis_interrupt?: boolean;\n\tduration_ms?: number;\n}\nexport interface StopHookInput extends HookInputCommon {\n\thook_event_name: \"Stop\";\n\tstop_hook_active: boolean;\n\tlast_assistant_message: string;\n\tbackground_tasks?: JsonObject[];\n\tsession_crons?: JsonObject[];\n}\nexport interface StopFailureHookInput extends HookInputCommon {\n\thook_event_name: \"StopFailure\";\n\terror: string;\n\terror_details?: string;\n\tlast_assistant_message?: string;\n}\nexport interface PreCompactHookInput extends HookInputCommon {\n\thook_event_name: \"PreCompact\";\n\ttrigger: CompactionHookTrigger;\n\tcustom_instructions: string;\n}\nexport interface PostCompactHookInput extends HookInputCommon {\n\thook_event_name: \"PostCompact\";\n\ttrigger: CompactionHookTrigger;\n\tcompact_summary: string;\n}\nexport type SessionEndReason = \"clear\" | \"resume\" | \"logout\" | \"prompt_input_exit\" | \"other\";\n\nexport interface SessionEndHookInput extends HookInputCommon {\n\thook_event_name: \"SessionEnd\";\n\treason: SessionEndReason;\n}\nexport type HookInput =\n\t| SessionStartHookInput\n\t| UserPromptSubmitHookInput\n\t| PreToolUseHookInput\n\t| PostToolUseHookInput\n\t| PostToolUseFailureHookInput\n\t| StopHookInput\n\t| StopFailureHookInput\n\t| PreCompactHookInput\n\t| PostCompactHookInput\n\t| SessionEndHookInput;\n\nexport type HookCommandShell = \"bash\" | \"powershell\";\nexport type UnsupportedHookHandlerType = \"prompt\" | \"agent\" | \"mcp_tool\";\n\nexport interface HookHandlerCommon {\n\ttimeout?: number;\n\tif?: string;\n\tstatusMessage?: string;\n}\nexport interface CommandHookHandler extends HookHandlerCommon {\n\ttype: \"command\";\n\tcommand: string;\n\targs?: string[];\n\tshell?: HookCommandShell;\n}\nexport interface HttpHookHandler extends HookHandlerCommon {\n\ttype: \"http\";\n\turl: string;\n\theaders?: Record<string, string>;\n\tallowedEnvVars?: string[];\n}\nexport interface UnsupportedHookHandler extends HookHandlerCommon {\n\ttype: UnsupportedHookHandlerType;\n}\nexport type HookHandler = CommandHookHandler | HttpHookHandler | UnsupportedHookHandler;\nexport interface HookGroup {\n\tmatcher?: string;\n\thooks: HookHandler[];\n}\nexport type HookConfiguration = Partial<Record<HookEventName, HookGroup[]>>;\n\nexport type HookSettingsSourceKind = \"user\" | \"project\" | \"local\" | \"host\";\nexport interface HookSettingsSource {\n\tkind: HookSettingsSourceKind;\n\tpath: string;\n}\nexport type HookDiagnosticCode =\n\t| \"read\"\n\t| \"parse\"\n\t| \"schema\"\n\t| \"unsupported-handler\"\n\t| \"invalid-regex\"\n\t| \"execution\"\n\t| \"policy\"\n\t| \"malformed-output\"\n\t| \"system-message\"\n\t| \"unsupported-update\"\n\t| \"continuation-cap\";\n\nexport type HookDiagnosticLevel = \"warning\" | \"error\";\n\nexport interface HookDiagnostic {\n\tlevel: HookDiagnosticLevel;\n\tcode: HookDiagnosticCode;\n\tmessage: string;\n\tsource?: HookSettingsSource;\n\tevent?: HookEventName;\n}\nexport interface LoadedHookHandler {\n\tevent: HookEventName;\n\tmatcher?: string;\n\thandler: HookHandler;\n\tsource: HookSettingsSource;\n\torder: number;\n\t/** Effective settings-policy environment allowlist for this HTTP hook. */\n\thttpHookAllowedEnvVars?: readonly string[];\n}\nexport interface LoadedHooks {\n\treadonly handlers: readonly LoadedHookHandler[];\n\treadonly diagnostics: readonly HookDiagnostic[];\n\treadonly sources: readonly HookSettingsSource[];\n}\n\nexport interface HookStructuredOutput {\n\tcontinue?: boolean;\n\tstopReason?: string;\n\tsuppressOutput?: boolean;\n\tsystemMessage?: string;\n\tterminalSequence?: string;\n\tdecision?: string;\n\treason?: string;\n\thookSpecificOutput?: JsonObject;\n}\nexport type HookOutputClassification =\n\t| { kind: \"empty\" }\n\t| { kind: \"text\"; text: string; malformedJson: boolean }\n\t| { kind: \"json\"; value: HookStructuredOutput };\nexport type HookExecutionStatus = \"completed\" | \"timeout\" | \"cancelled\" | \"error\" | \"unsupported\";\n\nexport interface HookExecutionResult {\n\thook: LoadedHookHandler;\n\tstatus: HookExecutionStatus;\n\texitCode: number | null;\n\tstdout: string;\n\tstderr: string;\n\tstdoutTruncated: boolean;\n\tstderrTruncated: boolean;\n\toutput: HookOutputClassification;\n\tblocking: boolean;\n\tblockingReason?: string;\n\tdurationMs: number;\n\tdiagnostic?: HookDiagnostic;\n}\n\nexport interface HookRunOptions {\n\t/** Active workspace backend used for project/local hook isolation. */\n\ttoolOperations?: Pick<ToolOperations, \"cwd\" | \"exec\" | \"getBackendInfo\">;\n\tsignal?: AbortSignal;\n\tenv?: NodeJS.ProcessEnv;\n\tmaxOutputBytes?: number;\n\tfetch?: typeof globalThis.fetch;\n\t/** Internal/test platform override for process-tree termination behavior. */\n\tplatform?: NodeJS.Platform;\n\t/** Internal/test override for Windows process-tree termination. Return false to request direct-child fallback. */\n\tterminateWindowsProcessTree?: (pid: number) => boolean;\n\t/** Shared timeout override (used for SessionEnd matching handlers). */\n\ttimeoutSeconds?: number;\n\t/** Host ceiling for HTTP destinations. Omitted means no additional host restriction. */\n\tallowedHttpHookUrls?: readonly string[];\n\t/** Host ceiling for HTTP header environment interpolation. */\n\thttpHookAllowedEnvVars?: readonly string[];\n}\nexport type HookPermissionDecision = \"allow\" | \"ask\" | \"defer\" | \"deny\";\n\nexport interface HookAggregateResult {\n\tcontinue: boolean;\n\tblocked: boolean;\n\treason?: string;\n\tadditionalContext: string[];\n\tsystemMessages: string[];\n\tplainText: string[];\n\tpermissionDecision?: HookPermissionDecision;\n\tupdatedInput?: JsonObject;\n\tupdatedToolOutput?: JsonValue;\n\tsessionTitle?: string;\n\tinitialUserMessage?: string;\n\t/** Aggregate remaining-work metric reported by Stop hooks. Lower values indicate progress. */\n\tstopContinuationProgress?: number;\n\treloadSkills?: boolean;\n\tresults: HookExecutionResult[];\n}\n\n/** Sanitized completed handler call for host UI rendering. */\nexport interface HookExecutionCallNotice {\n\ttype: HookHandler[\"type\"];\n\tlabel: string;\n\tsource: HookSettingsSource;\n\tstatus: HookExecutionStatus;\n\texitCode: number | null;\n\tdurationMs: number;\n}\n\n/** One completed hook event execution persisted as audit-only session data and exposed to host UI observers. */\nexport interface HookExecutionNotice {\n\tevent: HookEventName;\n\tsubject?: string;\n\tcalls: HookExecutionCallNotice[];\n\treturnedPrompts: string[];\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null;\n}\n\nexport function parseHookExecutionNotice(value: unknown): HookExecutionNotice | undefined {\n\tif (typeof value !== \"string\") return undefined;\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(value);\n\t} catch {\n\t\treturn undefined;\n\t}\n\tif (!isRecord(parsed) || typeof parsed.event !== \"string\") return undefined;\n\tif (!HOOK_EVENT_NAMES.includes(parsed.event as HookEventName)) return undefined;\n\tif (parsed.subject !== undefined && typeof parsed.subject !== \"string\") return undefined;\n\tif (\n\t\t!Array.isArray(parsed.returnedPrompts) ||\n\t\t!parsed.returnedPrompts.every((prompt) => typeof prompt === \"string\")\n\t) {\n\t\treturn undefined;\n\t}\n\tif (!Array.isArray(parsed.calls) || !parsed.calls.every(isHookExecutionCallNotice)) return undefined;\n\treturn parsed as unknown as HookExecutionNotice;\n}\n\nfunction isHookExecutionCallNotice(value: unknown): value is HookExecutionCallNotice {\n\tif (!isRecord(value) || !isRecord(value.source)) return false;\n\treturn (\n\t\ttypeof value.type === \"string\" &&\n\t\ttypeof value.label === \"string\" &&\n\t\ttypeof value.source.kind === \"string\" &&\n\t\ttypeof value.source.path === \"string\" &&\n\t\ttypeof value.status === \"string\" &&\n\t\t(value.exitCode === null || typeof value.exitCode === \"number\") &&\n\t\ttypeof value.durationMs === \"number\"\n\t);\n}\n\nexport type HookExecutionListener = (notice: HookExecutionNotice) => void;\nexport type HookExecutionActivityListener = (active: boolean) => void;\n"]}

package/dist/core/hooks/types.js

@@ -0,0 +1,52 @@
+export const HOOK_EVENT_NAMES = [
+    "SessionStart",
+    "UserPromptSubmit",
+    "PreToolUse",
+    "PostToolUse",
+    "PostToolUseFailure",
+    "Stop",
+    "StopFailure",
+    "PreCompact",
+    "PostCompact",
+    "SessionEnd",
+];
+export const HOOK_EXECUTION_CUSTOM_TYPE = "hook_execution";
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+export function parseHookExecutionNotice(value) {
+    if (typeof value !== "string")
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch {
+        return undefined;
+    }
+    if (!isRecord(parsed) || typeof parsed.event !== "string")
+        return undefined;
+    if (!HOOK_EVENT_NAMES.includes(parsed.event))
+        return undefined;
+    if (parsed.subject !== undefined && typeof parsed.subject !== "string")
+        return undefined;
+    if (!Array.isArray(parsed.returnedPrompts) ||
+        !parsed.returnedPrompts.every((prompt) => typeof prompt === "string")) {
+        return undefined;
+    }
+    if (!Array.isArray(parsed.calls) || !parsed.calls.every(isHookExecutionCallNotice))
+        return undefined;
+    return parsed;
+}
+function isHookExecutionCallNotice(value) {
+    if (!isRecord(value) || !isRecord(value.source))
+        return false;
+    return (typeof value.type === "string" &&
+        typeof value.label === "string" &&
+        typeof value.source.kind === "string" &&
+        typeof value.source.path === "string" &&
+        typeof value.status === "string" &&
+        (value.exitCode === null || typeof value.exitCode === "number") &&
+        typeof value.durationMs === "number");
+}
+//# sourceMappingURL=types.js.map

package/dist/core/hooks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/hooks/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC/B,cAAc;IACd,kBAAkB;IAClB,YAAY;IACZ,aAAa;IACb,oBAAoB;IACpB,MAAM;IACN,aAAa;IACb,YAAY;IACZ,aAAa;IACb,YAAY;CACH,CAAC;AACX,MAAM,CAAC,MAAM,0BAA0B,GAAG,gBAAgB,CAAC;AAiQ3D,SAAS,QAAQ,CAAC,KAAc,EAAoC;IACnE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AAAA,CACnD;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAc,EAAmC;IACzF,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACJ,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC5E,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAsB,CAAC;QAAE,OAAO,SAAS,CAAC;IAChF,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACzF,IACC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;QACtC,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,EACpE,CAAC;QACF,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,yBAAyB,CAAC;QAAE,OAAO,SAAS,CAAC;IACrG,OAAO,MAAwC,CAAC;AAAA,CAChD;AAED,SAAS,yBAAyB,CAAC,KAAc,EAAoC;IACpF,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9D,OAAO,CACN,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;QAC/B,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ;QACrC,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ;QACrC,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAChC,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC;QAC/D,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,CACpC,CAAC;AAAA,CACF","sourcesContent":["import type { ToolOperations } from \"../tools/operations.ts\";\n\nexport const HOOK_EVENT_NAMES = [\n\t\"SessionStart\",\n\t\"UserPromptSubmit\",\n\t\"PreToolUse\",\n\t\"PostToolUse\",\n\t\"PostToolUseFailure\",\n\t\"Stop\",\n\t\"StopFailure\",\n\t\"PreCompact\",\n\t\"PostCompact\",\n\t\"SessionEnd\",\n] as const;\nexport const HOOK_EXECUTION_CUSTOM_TYPE = \"hook_execution\";\n\nexport type HookEventName = (typeof HOOK_EVENT_NAMES)[number];\nexport type JsonPrimitive = string | number | boolean | null;\nexport type JsonValue = JsonPrimitive | JsonValue[] | { [key: string]: JsonValue };\nexport type JsonObject = { [key: string]: JsonValue };\n\nexport type PermissionMode = \"default\" | \"plan\" | \"acceptEdits\" | \"auto\" | \"dontAsk\" | \"bypassPermissions\";\nexport type HookEffortLevel = \"low\" | \"medium\" | \"high\" | \"xhigh\" | \"max\";\n\nexport interface HookEffort {\n\tlevel: HookEffortLevel;\n}\nexport type SessionStartHookSource = \"startup\" | \"resume\" | \"clear\" | \"compact\" | \"fork\";\nexport type CompactionHookTrigger = \"manual\" | \"auto\";\n\nexport interface HookInputCommon {\n\tsession_id: string;\n\ttranscript_path: string;\n\tcwd: string;\n\thook_event_name: HookEventName;\n\tprompt_id?: string;\n\tpermission_mode?: PermissionMode;\n\tagent_id?: string;\n\tagent_type?: string;\n\teffort?: HookEffort;\n}\n\nexport interface SessionStartHookInput extends HookInputCommon {\n\thook_event_name: \"SessionStart\";\n\tsource: SessionStartHookSource;\n\tmodel?: string;\n\tsession_title?: string;\n}\nexport interface UserPromptSubmitHookInput extends HookInputCommon {\n\thook_event_name: \"UserPromptSubmit\";\n\tprompt: string;\n}\nexport interface ToolHookInput extends HookInputCommon {\n\ttool_name: string;\n\ttool_input: JsonObject;\n\ttool_use_id: string;\n}\nexport interface PreToolUseHookInput extends ToolHookInput {\n\thook_event_name: \"PreToolUse\";\n}\nexport interface PostToolUseHookInput extends ToolHookInput {\n\thook_event_name: \"PostToolUse\";\n\ttool_response: JsonValue;\n\tduration_ms?: number;\n}\nexport interface PostToolUseFailureHookInput extends ToolHookInput {\n\thook_event_name: \"PostToolUseFailure\";\n\terror: string;\n\tis_interrupt?: boolean;\n\tduration_ms?: number;\n}\nexport interface StopHookInput extends HookInputCommon {\n\thook_event_name: \"Stop\";\n\tstop_hook_active: boolean;\n\tlast_assistant_message: string;\n\tbackground_tasks?: JsonObject[];\n\tsession_crons?: JsonObject[];\n}\nexport interface StopFailureHookInput extends HookInputCommon {\n\thook_event_name: \"StopFailure\";\n\terror: string;\n\terror_details?: string;\n\tlast_assistant_message?: string;\n}\nexport interface PreCompactHookInput extends HookInputCommon {\n\thook_event_name: \"PreCompact\";\n\ttrigger: CompactionHookTrigger;\n\tcustom_instructions: string;\n}\nexport interface PostCompactHookInput extends HookInputCommon {\n\thook_event_name: \"PostCompact\";\n\ttrigger: CompactionHookTrigger;\n\tcompact_summary: string;\n}\nexport type SessionEndReason = \"clear\" | \"resume\" | \"logout\" | \"prompt_input_exit\" | \"other\";\n\nexport interface SessionEndHookInput extends HookInputCommon {\n\thook_event_name: \"SessionEnd\";\n\treason: SessionEndReason;\n}\nexport type HookInput =\n\t| SessionStartHookInput\n\t| UserPromptSubmitHookInput\n\t| PreToolUseHookInput\n\t| PostToolUseHookInput\n\t| PostToolUseFailureHookInput\n\t| StopHookInput\n\t| StopFailureHookInput\n\t| PreCompactHookInput\n\t| PostCompactHookInput\n\t| SessionEndHookInput;\n\nexport type HookCommandShell = \"bash\" | \"powershell\";\nexport type UnsupportedHookHandlerType = \"prompt\" | \"agent\" | \"mcp_tool\";\n\nexport interface HookHandlerCommon {\n\ttimeout?: number;\n\tif?: string;\n\tstatusMessage?: string;\n}\nexport interface CommandHookHandler extends HookHandlerCommon {\n\ttype: \"command\";\n\tcommand: string;\n\targs?: string[];\n\tshell?: HookCommandShell;\n}\nexport interface HttpHookHandler extends HookHandlerCommon {\n\ttype: \"http\";\n\turl: string;\n\theaders?: Record<string, string>;\n\tallowedEnvVars?: string[];\n}\nexport interface UnsupportedHookHandler extends HookHandlerCommon {\n\ttype: UnsupportedHookHandlerType;\n}\nexport type HookHandler = CommandHookHandler | HttpHookHandler | UnsupportedHookHandler;\nexport interface HookGroup {\n\tmatcher?: string;\n\thooks: HookHandler[];\n}\nexport type HookConfiguration = Partial<Record<HookEventName, HookGroup[]>>;\n\nexport type HookSettingsSourceKind = \"user\" | \"project\" | \"local\" | \"host\";\nexport interface HookSettingsSource {\n\tkind: HookSettingsSourceKind;\n\tpath: string;\n}\nexport type HookDiagnosticCode =\n\t| \"read\"\n\t| \"parse\"\n\t| \"schema\"\n\t| \"unsupported-handler\"\n\t| \"invalid-regex\"\n\t| \"execution\"\n\t| \"policy\"\n\t| \"malformed-output\"\n\t| \"system-message\"\n\t| \"unsupported-update\"\n\t| \"continuation-cap\";\n\nexport type HookDiagnosticLevel = \"warning\" | \"error\";\n\nexport interface HookDiagnostic {\n\tlevel: HookDiagnosticLevel;\n\tcode: HookDiagnosticCode;\n\tmessage: string;\n\tsource?: HookSettingsSource;\n\tevent?: HookEventName;\n}\nexport interface LoadedHookHandler {\n\tevent: HookEventName;\n\tmatcher?: string;\n\thandler: HookHandler;\n\tsource: HookSettingsSource;\n\torder: number;\n\t/** Effective settings-policy environment allowlist for this HTTP hook. */\n\thttpHookAllowedEnvVars?: readonly string[];\n}\nexport interface LoadedHooks {\n\treadonly handlers: readonly LoadedHookHandler[];\n\treadonly diagnostics: readonly HookDiagnostic[];\n\treadonly sources: readonly HookSettingsSource[];\n}\n\nexport interface HookStructuredOutput {\n\tcontinue?: boolean;\n\tstopReason?: string;\n\tsuppressOutput?: boolean;\n\tsystemMessage?: string;\n\tterminalSequence?: string;\n\tdecision?: string;\n\treason?: string;\n\thookSpecificOutput?: JsonObject;\n}\nexport type HookOutputClassification =\n\t| { kind: \"empty\" }\n\t| { kind: \"text\"; text: string; malformedJson: boolean }\n\t| { kind: \"json\"; value: HookStructuredOutput };\nexport type HookExecutionStatus = \"completed\" | \"timeout\" | \"cancelled\" | \"error\" | \"unsupported\";\n\nexport interface HookExecutionResult {\n\thook: LoadedHookHandler;\n\tstatus: HookExecutionStatus;\n\texitCode: number | null;\n\tstdout: string;\n\tstderr: string;\n\tstdoutTruncated: boolean;\n\tstderrTruncated: boolean;\n\toutput: HookOutputClassification;\n\tblocking: boolean;\n\tblockingReason?: string;\n\tdurationMs: number;\n\tdiagnostic?: HookDiagnostic;\n}\n\nexport interface HookRunOptions {\n\t/** Active workspace backend used for project/local hook isolation. */\n\ttoolOperations?: Pick<ToolOperations, \"cwd\" | \"exec\" | \"getBackendInfo\">;\n\tsignal?: AbortSignal;\n\tenv?: NodeJS.ProcessEnv;\n\tmaxOutputBytes?: number;\n\tfetch?: typeof globalThis.fetch;\n\t/** Internal/test platform override for process-tree termination behavior. */\n\tplatform?: NodeJS.Platform;\n\t/** Internal/test override for Windows process-tree termination. Return false to request direct-child fallback. */\n\tterminateWindowsProcessTree?: (pid: number) => boolean;\n\t/** Shared timeout override (used for SessionEnd matching handlers). */\n\ttimeoutSeconds?: number;\n\t/** Host ceiling for HTTP destinations. Omitted means no additional host restriction. */\n\tallowedHttpHookUrls?: readonly string[];\n\t/** Host ceiling for HTTP header environment interpolation. */\n\thttpHookAllowedEnvVars?: readonly string[];\n}\nexport type HookPermissionDecision = \"allow\" | \"ask\" | \"defer\" | \"deny\";\n\nexport interface HookAggregateResult {\n\tcontinue: boolean;\n\tblocked: boolean;\n\treason?: string;\n\tadditionalContext: string[];\n\tsystemMessages: string[];\n\tplainText: string[];\n\tpermissionDecision?: HookPermissionDecision;\n\tupdatedInput?: JsonObject;\n\tupdatedToolOutput?: JsonValue;\n\tsessionTitle?: string;\n\tinitialUserMessage?: string;\n\t/** Aggregate remaining-work metric reported by Stop hooks. Lower values indicate progress. */\n\tstopContinuationProgress?: number;\n\treloadSkills?: boolean;\n\tresults: HookExecutionResult[];\n}\n\n/** Sanitized completed handler call for host UI rendering. */\nexport interface HookExecutionCallNotice {\n\ttype: HookHandler[\"type\"];\n\tlabel: string;\n\tsource: HookSettingsSource;\n\tstatus: HookExecutionStatus;\n\texitCode: number | null;\n\tdurationMs: number;\n}\n\n/** One completed hook event execution persisted as audit-only session data and exposed to host UI observers. */\nexport interface HookExecutionNotice {\n\tevent: HookEventName;\n\tsubject?: string;\n\tcalls: HookExecutionCallNotice[];\n\treturnedPrompts: string[];\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null;\n}\n\nexport function parseHookExecutionNotice(value: unknown): HookExecutionNotice | undefined {\n\tif (typeof value !== \"string\") return undefined;\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(value);\n\t} catch {\n\t\treturn undefined;\n\t}\n\tif (!isRecord(parsed) || typeof parsed.event !== \"string\") return undefined;\n\tif (!HOOK_EVENT_NAMES.includes(parsed.event as HookEventName)) return undefined;\n\tif (parsed.subject !== undefined && typeof parsed.subject !== \"string\") return undefined;\n\tif (\n\t\t!Array.isArray(parsed.returnedPrompts) ||\n\t\t!parsed.returnedPrompts.every((prompt) => typeof prompt === \"string\")\n\t) {\n\t\treturn undefined;\n\t}\n\tif (!Array.isArray(parsed.calls) || !parsed.calls.every(isHookExecutionCallNotice)) return undefined;\n\treturn parsed as unknown as HookExecutionNotice;\n}\n\nfunction isHookExecutionCallNotice(value: unknown): value is HookExecutionCallNotice {\n\tif (!isRecord(value) || !isRecord(value.source)) return false;\n\treturn (\n\t\ttypeof value.type === \"string\" &&\n\t\ttypeof value.label === \"string\" &&\n\t\ttypeof value.source.kind === \"string\" &&\n\t\ttypeof value.source.path === \"string\" &&\n\t\ttypeof value.status === \"string\" &&\n\t\t(value.exitCode === null || typeof value.exitCode === \"number\") &&\n\t\ttypeof value.durationMs === \"number\"\n\t);\n}\n\nexport type HookExecutionListener = (notice: HookExecutionNotice) => void;\nexport type HookExecutionActivityListener = (active: boolean) => void;\n"]}

package/dist/core/http-dispatcher.d.ts

@@ -0,0 +1,21 @@
+export declare const DEFAULT_HTTP_IDLE_TIMEOUT_MS = 300000;
+export declare const HTTP_IDLE_TIMEOUT_CHOICES: readonly [{
+    readonly label: "30 sec";
+    readonly timeoutMs: 30000;
+}, {
+    readonly label: "1 min";
+    readonly timeoutMs: 60000;
+}, {
+    readonly label: "2 min";
+    readonly timeoutMs: 120000;
+}, {
+    readonly label: "5 min";
+    readonly timeoutMs: 300000;
+}, {
+    readonly label: "disabled";
+    readonly timeoutMs: 0;
+}];
+export declare function parseHttpIdleTimeoutMs(value: unknown): number | undefined;
+export declare function formatHttpIdleTimeoutMs(timeoutMs: number): string;
+export declare function configureHttpDispatcher(timeoutMs?: number): void;
+//# sourceMappingURL=http-dispatcher.d.ts.map

package/dist/core/http-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-dispatcher.d.ts","sourceRoot":"","sources":["../../src/core/http-dispatcher.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,4BAA4B,SAAU,CAAC;AAEpD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;EAM5B,CAAC;AAEX,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAgBzE;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMjE;AAmCD,wBAAgB,uBAAuB,CAAC,SAAS,GAAE,MAAqC,GAAG,IAAI,CAuB9F","sourcesContent":["import { EventEmitter } from \"node:events\";\nimport * as undici from \"undici\";\n\nexport const DEFAULT_HTTP_IDLE_TIMEOUT_MS = 300_000;\n\nexport const HTTP_IDLE_TIMEOUT_CHOICES = [\n\t{ label: \"30 sec\", timeoutMs: 30_000 },\n\t{ label: \"1 min\", timeoutMs: 60_000 },\n\t{ label: \"2 min\", timeoutMs: 120_000 },\n\t{ label: \"5 min\", timeoutMs: 300_000 },\n\t{ label: \"disabled\", timeoutMs: 0 },\n] as const;\n\nexport function parseHttpIdleTimeoutMs(value: unknown): number | undefined {\n\tif (typeof value === \"string\") {\n\t\tconst trimmed = value.trim();\n\t\tif (trimmed.toLowerCase() === \"disabled\") {\n\t\t\treturn 0;\n\t\t}\n\t\tif (trimmed.length === 0) {\n\t\t\treturn undefined;\n\t\t}\n\t\treturn parseHttpIdleTimeoutMs(Number(trimmed));\n\t}\n\n\tif (typeof value !== \"number\" || !Number.isFinite(value) || value < 0) {\n\t\treturn undefined;\n\t}\n\treturn Math.floor(value);\n}\n\nexport function formatHttpIdleTimeoutMs(timeoutMs: number): string {\n\tconst choice = HTTP_IDLE_TIMEOUT_CHOICES.find((item) => item.timeoutMs === timeoutMs);\n\tif (choice) {\n\t\treturn choice.label;\n\t}\n\treturn `${timeoutMs / 1000} sec`;\n}\n\nconst ignoreUndiciDispatcherError = (_error: unknown): void => {};\n\n// Undici can emit an internal Client \"error\" while terminating a mid-stream\n// fetch body. The body stream still rejects through reader.read(); this listener\n// only prevents EventEmitter's unhandled \"error\" special case from crashing grip.\nfunction withUndiciErrorListener<T extends undici.Dispatcher>(dispatcher: T): T {\n\tif (dispatcher instanceof EventEmitter) {\n\t\tEventEmitter.prototype.on.call(dispatcher, \"error\", ignoreUndiciDispatcherError);\n\t}\n\treturn dispatcher;\n}\n\nfunction createUndiciClient(origin: string | URL, options: object): undici.Dispatcher {\n\treturn withUndiciErrorListener(new undici.Client(origin, options as undici.Client.Options));\n}\n\nfunction createUndiciOriginDispatcher(origin: string | URL, options: object): undici.Dispatcher {\n\tconst dispatcherOptions = options as undici.Pool.Options;\n\tif (dispatcherOptions.connections === 1) {\n\t\treturn createUndiciClient(origin, dispatcherOptions);\n\t}\n\treturn withUndiciErrorListener(\n\t\tnew undici.Pool(origin, {\n\t\t\t...dispatcherOptions,\n\t\t\tfactory: createUndiciClient,\n\t\t}),\n\t);\n}\n\nfunction isMockedFetch(fetchImplementation: typeof globalThis.fetch | undefined): boolean {\n\treturn (fetchImplementation as { _isMockFunction?: unknown } | undefined)?._isMockFunction === true;\n}\n\nexport function configureHttpDispatcher(timeoutMs: number = DEFAULT_HTTP_IDLE_TIMEOUT_MS): void {\n\tconst normalizedTimeoutMs = parseHttpIdleTimeoutMs(timeoutMs);\n\tif (normalizedTimeoutMs === undefined) {\n\t\tthrow new Error(`Invalid HTTP idle timeout: ${String(timeoutMs)}`);\n\t}\n\tconst dispatcher = withUndiciErrorListener(\n\t\tnew undici.EnvHttpProxyAgent({\n\t\t\tallowH2: false,\n\t\t\tbodyTimeout: normalizedTimeoutMs,\n\t\t\theadersTimeout: normalizedTimeoutMs,\n\t\t\tclientFactory: createUndiciClient,\n\t\t\tfactory: createUndiciOriginDispatcher,\n\t\t}),\n\t);\n\tundici.setGlobalDispatcher(dispatcher);\n\t// Keep fetch and the dispatcher on the same undici implementation. Node 26.0's\n\t// bundled fetch can otherwise consume compressed responses through npm undici's\n\t// dispatcher without decompressing them, causing response.json() failures.\n\tconst existingFetch = globalThis.fetch;\n\tundici.install?.();\n\tif (isMockedFetch(existingFetch)) {\n\t\tglobalThis.fetch = existingFetch;\n\t}\n}\n"]}

package/dist/core/http-dispatcher.js

@@ -0,0 +1,82 @@
+import { EventEmitter } from "node:events";
+import * as undici from "undici";
+export const DEFAULT_HTTP_IDLE_TIMEOUT_MS = 300_000;
+export const HTTP_IDLE_TIMEOUT_CHOICES = [
+    { label: "30 sec", timeoutMs: 30_000 },
+    { label: "1 min", timeoutMs: 60_000 },
+    { label: "2 min", timeoutMs: 120_000 },
+    { label: "5 min", timeoutMs: 300_000 },
+    { label: "disabled", timeoutMs: 0 },
+];
+export function parseHttpIdleTimeoutMs(value) {
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        if (trimmed.toLowerCase() === "disabled") {
+            return 0;
+        }
+        if (trimmed.length === 0) {
+            return undefined;
+        }
+        return parseHttpIdleTimeoutMs(Number(trimmed));
+    }
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+        return undefined;
+    }
+    return Math.floor(value);
+}
+export function formatHttpIdleTimeoutMs(timeoutMs) {
+    const choice = HTTP_IDLE_TIMEOUT_CHOICES.find((item) => item.timeoutMs === timeoutMs);
+    if (choice) {
+        return choice.label;
+    }
+    return `${timeoutMs / 1000} sec`;
+}
+const ignoreUndiciDispatcherError = (_error) => { };
+// Undici can emit an internal Client "error" while terminating a mid-stream
+// fetch body. The body stream still rejects through reader.read(); this listener
+// only prevents EventEmitter's unhandled "error" special case from crashing grip.
+function withUndiciErrorListener(dispatcher) {
+    if (dispatcher instanceof EventEmitter) {
+        EventEmitter.prototype.on.call(dispatcher, "error", ignoreUndiciDispatcherError);
+    }
+    return dispatcher;
+}
+function createUndiciClient(origin, options) {
+    return withUndiciErrorListener(new undici.Client(origin, options));
+}
+function createUndiciOriginDispatcher(origin, options) {
+    const dispatcherOptions = options;
+    if (dispatcherOptions.connections === 1) {
+        return createUndiciClient(origin, dispatcherOptions);
+    }
+    return withUndiciErrorListener(new undici.Pool(origin, {
+        ...dispatcherOptions,
+        factory: createUndiciClient,
+    }));
+}
+function isMockedFetch(fetchImplementation) {
+    return fetchImplementation?._isMockFunction === true;
+}
+export function configureHttpDispatcher(timeoutMs = DEFAULT_HTTP_IDLE_TIMEOUT_MS) {
+    const normalizedTimeoutMs = parseHttpIdleTimeoutMs(timeoutMs);
+    if (normalizedTimeoutMs === undefined) {
+        throw new Error(`Invalid HTTP idle timeout: ${String(timeoutMs)}`);
+    }
+    const dispatcher = withUndiciErrorListener(new undici.EnvHttpProxyAgent({
+        allowH2: false,
+        bodyTimeout: normalizedTimeoutMs,
+        headersTimeout: normalizedTimeoutMs,
+        clientFactory: createUndiciClient,
+        factory: createUndiciOriginDispatcher,
+    }));
+    undici.setGlobalDispatcher(dispatcher);
+    // Keep fetch and the dispatcher on the same undici implementation. Node 26.0's
+    // bundled fetch can otherwise consume compressed responses through npm undici's
+    // dispatcher without decompressing them, causing response.json() failures.
+    const existingFetch = globalThis.fetch;
+    undici.install?.();
+    if (isMockedFetch(existingFetch)) {
+        globalThis.fetch = existingFetch;
+    }
+}
+//# sourceMappingURL=http-dispatcher.js.map

package/dist/core/http-dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-dispatcher.js","sourceRoot":"","sources":["../../src/core/http-dispatcher.ts"],"names":[],"mappings":"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","sourcesContent":["import { EventEmitter } from \"node:events\";\nimport * as undici from \"undici\";\n\nexport const DEFAULT_HTTP_IDLE_TIMEOUT_MS = 300_000;\n\nexport const HTTP_IDLE_TIMEOUT_CHOICES = [\n\t{ label: \"30 sec\", timeoutMs: 30_000 },\n\t{ label: \"1 min\", timeoutMs: 60_000 },\n\t{ label: \"2 min\", timeoutMs: 120_000 },\n\t{ label: \"5 min\", timeoutMs: 300_000 },\n\t{ label: \"disabled\", timeoutMs: 0 },\n] as const;\n\nexport function parseHttpIdleTimeoutMs(value: unknown): number | undefined {\n\tif (typeof value === \"string\") {\n\t\tconst trimmed = value.trim();\n\t\tif (trimmed.toLowerCase() === \"disabled\") {\n\t\t\treturn 0;\n\t\t}\n\t\tif (trimmed.length === 0) {\n\t\t\treturn undefined;\n\t\t}\n\t\treturn parseHttpIdleTimeoutMs(Number(trimmed));\n\t}\n\n\tif (typeof value !== \"number\" || !Number.isFinite(value) || value < 0) {\n\t\treturn undefined;\n\t}\n\treturn Math.floor(value);\n}\n\nexport function formatHttpIdleTimeoutMs(timeoutMs: number): string {\n\tconst choice = HTTP_IDLE_TIMEOUT_CHOICES.find((item) => item.timeoutMs === timeoutMs);\n\tif (choice) {\n\t\treturn choice.label;\n\t}\n\treturn `${timeoutMs / 1000} sec`;\n}\n\nconst ignoreUndiciDispatcherError = (_error: unknown): void => {};\n\n// Undici can emit an internal Client \"error\" while terminating a mid-stream\n// fetch body. The body stream still rejects through reader.read(); this listener\n// only prevents EventEmitter's unhandled \"error\" special case from crashing grip.\nfunction withUndiciErrorListener<T extends undici.Dispatcher>(dispatcher: T): T {\n\tif (dispatcher instanceof EventEmitter) {\n\t\tEventEmitter.prototype.on.call(dispatcher, \"error\", ignoreUndiciDispatcherError);\n\t}\n\treturn dispatcher;\n}\n\nfunction createUndiciClient(origin: string | URL, options: object): undici.Dispatcher {\n\treturn withUndiciErrorListener(new undici.Client(origin, options as undici.Client.Options));\n}\n\nfunction createUndiciOriginDispatcher(origin: string | URL, options: object): undici.Dispatcher {\n\tconst dispatcherOptions = options as undici.Pool.Options;\n\tif (dispatcherOptions.connections === 1) {\n\t\treturn createUndiciClient(origin, dispatcherOptions);\n\t}\n\treturn withUndiciErrorListener(\n\t\tnew undici.Pool(origin, {\n\t\t\t...dispatcherOptions,\n\t\t\tfactory: createUndiciClient,\n\t\t}),\n\t);\n}\n\nfunction isMockedFetch(fetchImplementation: typeof globalThis.fetch | undefined): boolean {\n\treturn (fetchImplementation as { _isMockFunction?: unknown } | undefined)?._isMockFunction === true;\n}\n\nexport function configureHttpDispatcher(timeoutMs: number = DEFAULT_HTTP_IDLE_TIMEOUT_MS): void {\n\tconst normalizedTimeoutMs = parseHttpIdleTimeoutMs(timeoutMs);\n\tif (normalizedTimeoutMs === undefined) {\n\t\tthrow new Error(`Invalid HTTP idle timeout: ${String(timeoutMs)}`);\n\t}\n\tconst dispatcher = withUndiciErrorListener(\n\t\tnew undici.EnvHttpProxyAgent({\n\t\t\tallowH2: false,\n\t\t\tbodyTimeout: normalizedTimeoutMs,\n\t\t\theadersTimeout: normalizedTimeoutMs,\n\t\t\tclientFactory: createUndiciClient,\n\t\t\tfactory: createUndiciOriginDispatcher,\n\t\t}),\n\t);\n\tundici.setGlobalDispatcher(dispatcher);\n\t// Keep fetch and the dispatcher on the same undici implementation. Node 26.0's\n\t// bundled fetch can otherwise consume compressed responses through npm undici's\n\t// dispatcher without decompressing them, causing response.json() failures.\n\tconst existingFetch = globalThis.fetch;\n\tundici.install?.();\n\tif (isMockedFetch(existingFetch)) {\n\t\tglobalThis.fetch = existingFetch;\n\t}\n}\n"]}

package/dist/core/instruction-resource-loader.d.ts

@@ -0,0 +1,81 @@
+import type { ResourceCollision, ResourceDiagnostic } from "./diagnostics.ts";
+import { type SourceInfo } from "./source-info.ts";
+import type { ToolOperations } from "./tools/operations.ts";
+export interface InstructionResourceFrontmatter {
+    name?: string;
+    description?: string;
+    tools?: string | string[];
+    "disable-model-invocation"?: boolean;
+    [key: string]: unknown;
+}
+export interface InstructionResource {
+    name: string;
+    description: string;
+    filePath: string;
+    baseDir: string;
+    sourceInfo: SourceInfo;
+    disableModelInvocation: boolean;
+    tools?: string[];
+    content?: string;
+}
+export interface InstructionResourceLoadResult<TResource extends InstructionResource> {
+    resources: TResource[];
+    diagnostics: ResourceDiagnostic[];
+}
+export interface InstructionResourceDirectoryOptions {
+    /** Directory to scan for instruction resources. */
+    dir: string;
+    /** Source identifier for these instruction resources. */
+    source: string;
+}
+interface InstructionResourcePromptFormatOptions {
+    intro: string[];
+    containerTag: string;
+    itemTag: string;
+}
+export interface InstructionResourceLoaderOptions {
+    cwd: string;
+    agentDir: string;
+    resourcePaths: string[];
+    includeDefaults: boolean;
+}
+export interface InstructionResourceLoaderWithOperationsOptions extends InstructionResourceLoaderOptions {
+    operations: ToolOperations;
+}
+export interface InstructionResourceLoaderConfig {
+    resourceType: ResourceCollision["resourceType"];
+    defaultDirectoryName: string;
+    rootFileName: string;
+}
+export declare abstract class InstructionResourceLoader<TResource extends InstructionResource, TFrontmatter extends InstructionResourceFrontmatter> {
+    private resourceType;
+    private defaultDirectoryName;
+    private rootFileName;
+    constructor(config: InstructionResourceLoaderConfig);
+    protected abstract createResource(resource: InstructionResource, frontmatter: TFrontmatter): TResource;
+    protected loadResourcesFromDir(dir: string, source: string): InstructionResourceLoadResult<TResource>;
+    private loadResourcesFromConfiguredPath;
+    protected loadResources(options: InstructionResourceLoaderOptions): InstructionResourceLoadResult<TResource>;
+    private loadResourcesFromConfiguredPathWithOperations;
+    protected loadResourcesWithOperations(options: InstructionResourceLoaderWithOperationsOptions): Promise<InstructionResourceLoadResult<TResource>>;
+    private createCollisionDiagnostic;
+    private addIgnoreRules;
+    private addIgnoreRulesWithOperations;
+    private getLocalResourceEntry;
+    private loadRootResourceFromEntries;
+    private loadNestedResourceEntry;
+    private loadNestedResourcesFromEntries;
+    private loadResourcesFromDirInternal;
+    private getBackendResourceEntry;
+    private loadRootResourceWithOperations;
+    private loadNestedResourceWithOperations;
+    private loadNestedResourcesWithOperations;
+    private loadResourcesFromDirInternalWithOperations;
+    private loadResourceFromFile;
+    private loadResourceFromFileWithOperations;
+    private parseResource;
+    private createParseError;
+}
+export declare function formatInstructionResourcesForPrompt(resources: InstructionResource[], options: InstructionResourcePromptFormatOptions): string;
+export {};
+//# sourceMappingURL=instruction-resource-loader.d.ts.map