@code-yeongyu/senpi 2026.6.15 → 2026.6.16

package/dist/core/extensions/builtin/rules/rules/types.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Public types for pi-rules.
+ *
+ * These types are stable contracts between modules. The frontmatter type
+ * mirrors omo's `RuleMetadata` plus Claude (`paths`) and Copilot (`applyTo`)
+ * aliases that are normalized into `globs` internally.
+ */
+/**
+ * YAML frontmatter parsed from a rule markdown file.
+ * `paths` (Claude alias) and `applyTo` (Copilot alias) are normalized into
+ * `globs` by the parser before any matcher sees this struct.
+ */
+export interface RuleFrontmatter {
+    description?: string;
+    globs?: string | string[];
+    paths?: string | string[];
+    applyTo?: string | string[];
+    alwaysApply?: boolean;
+}
+/**
+ * Result of parsing a rule markdown file.
+ * `body` excludes the frontmatter delimiters and the YAML payload.
+ */
+export interface ParsedRule {
+    frontmatter: RuleFrontmatter;
+    body: string;
+    /**
+     * Diagnostic message if frontmatter parsing failed but the body was salvaged.
+     * Empty when parsing succeeded.
+     */
+    diagnostic?: string;
+}
+/**
+ * A discovered rule file candidate before parsing/matching.
+ *
+ * `path` is the absolute path as discovered (possibly via symlink).
+ * `realPath` is the canonical resolved path used for dedup.
+ * `source` identifies which discovery source produced this candidate.
+ */
+export interface RuleCandidate {
+    path: string;
+    realPath: string;
+    source: RuleSource;
+    /**
+     * Distance from the target file directory to the directory containing this rule.
+     * 0 = same directory, 9999 = global/user-home rule.
+     */
+    distance: number;
+    isGlobal: boolean;
+    /**
+     * True when this candidate is a SINGLE-FILE rule like AGENTS.md or
+     * `.github/copilot-instructions.md` (frontmatter optional, applies always).
+     */
+    isSingleFile: boolean;
+    /**
+     * Path relative to project root, POSIX-normalized. Used for matcher and display.
+     * Empty string for user-home global rules.
+     */
+    relativePath: string;
+}
+/**
+ * A fully-loaded rule ready for injection.
+ */
+export interface LoadedRule extends RuleCandidate {
+    frontmatter: RuleFrontmatter;
+    body: string;
+    contentHash: string;
+    matchReason: MatchReason;
+}
+/**
+ * Source identifier for rule files. Used for deterministic ordering and display.
+ */
+export type RuleSource = ".omo/rules" | ".claude/rules" | ".cursor/rules" | ".github/instructions" | ".github/copilot-instructions.md" | "AGENTS.md" | "CLAUDE.md" | "CONTEXT.md" | "~/.omo/rules" | "~/.opencode/rules" | "~/.claude/rules" | "~/.config/opencode/AGENTS.md" | "~/.claude/CLAUDE.md";
+/**
+ * Why a candidate matched the target file. Surfaced in the injection block so
+ * the model can attribute its behavior to a specific rule.
+ */
+export type MatchReason = "alwaysApply" | "single-file" | {
+    kind: "glob";
+    pattern: string;
+} | {
+    kind: "no-match";
+};
+/**
+ * Truncation result.
+ */
+export interface TruncationResult {
+    body: string;
+    truncated: boolean;
+    originalLength: number;
+}
+/**
+ * Configuration knobs resolved from env vars and package.json.
+ */
+export interface PiRulesConfig {
+    disabled: boolean;
+    mode: "static" | "dynamic" | "both" | "off";
+    maxRuleChars: number;
+    maxResultChars: number;
+    enabledSources: RuleSource[] | "auto";
+}
+/**
+ * Per-session in-memory dedup state.
+ *
+ * `staticDedup` keys are `{cwd}::{rulePath}::{contentHash}` strings.
+ * `dynamicDedup` stores `{targetPath}::{rulePath}::{contentHash}` strings grouped by target file.
+ * `dynamicTargetFingerprints` maps a target file cache key to a digest of its
+ * discovered rule candidates + file stats; loadDynamicRules short-circuits
+ * targets whose fingerprint has not changed since the previous load.
+ */
+export interface SessionState {
+    cwd: string | undefined;
+    staticDedup: Set<string>;
+    dynamicDedup: Map<string, Set<string>>;
+    dynamicTargetFingerprints: Map<string, string>;
+    loadedRules: LoadedRule[];
+    diagnostics: RuleDiagnostic[];
+}
+export interface RuleDiagnostic {
+    severity: "warning" | "error";
+    source: string;
+    message: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/extensions/builtin/rules/rules/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/rules/rules/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IAC1B,WAAW,EAAE,eAAe,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,aAAa;IAChD,WAAW,EAAE,eAAe,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GACnB,YAAY,GACZ,eAAe,GACf,eAAe,GACf,sBAAsB,GACtB,iCAAiC,GACjC,WAAW,GACX,WAAW,GACX,YAAY,GACZ,cAAc,GACd,mBAAmB,GACnB,iBAAiB,GACjB,8BAA8B,GAC9B,qBAAqB,CAAC;AAEzB;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAEnH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,CAAC;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;CACtC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACvC,yBAAyB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,WAAW,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CAChB"}

package/dist/core/extensions/builtin/rules/rules/types.js

@@ -0,0 +1,9 @@
+/**
+ * Public types for pi-rules.
+ *
+ * These types are stable contracts between modules. The frontmatter type
+ * mirrors omo's `RuleMetadata` plus Claude (`paths`) and Copilot (`applyTo`)
+ * aliases that are normalized into `globs` internally.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/extensions/builtin/rules/rules/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/rules/rules/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG","sourcesContent":["/**\n * Public types for pi-rules.\n *\n * These types are stable contracts between modules. The frontmatter type\n * mirrors omo's `RuleMetadata` plus Claude (`paths`) and Copilot (`applyTo`)\n * aliases that are normalized into `globs` internally.\n */\n\n/**\n * YAML frontmatter parsed from a rule markdown file.\n * `paths` (Claude alias) and `applyTo` (Copilot alias) are normalized into\n * `globs` by the parser before any matcher sees this struct.\n */\nexport interface RuleFrontmatter {\n\tdescription?: string;\n\tglobs?: string | string[];\n\tpaths?: string | string[];\n\tapplyTo?: string | string[];\n\talwaysApply?: boolean;\n}\n\n/**\n * Result of parsing a rule markdown file.\n * `body` excludes the frontmatter delimiters and the YAML payload.\n */\nexport interface ParsedRule {\n\tfrontmatter: RuleFrontmatter;\n\tbody: string;\n\t/**\n\t * Diagnostic message if frontmatter parsing failed but the body was salvaged.\n\t * Empty when parsing succeeded.\n\t */\n\tdiagnostic?: string;\n}\n\n/**\n * A discovered rule file candidate before parsing/matching.\n *\n * `path` is the absolute path as discovered (possibly via symlink).\n * `realPath` is the canonical resolved path used for dedup.\n * `source` identifies which discovery source produced this candidate.\n */\nexport interface RuleCandidate {\n\tpath: string;\n\trealPath: string;\n\tsource: RuleSource;\n\t/**\n\t * Distance from the target file directory to the directory containing this rule.\n\t * 0 = same directory, 9999 = global/user-home rule.\n\t */\n\tdistance: number;\n\tisGlobal: boolean;\n\t/**\n\t * True when this candidate is a SINGLE-FILE rule like AGENTS.md or\n\t * `.github/copilot-instructions.md` (frontmatter optional, applies always).\n\t */\n\tisSingleFile: boolean;\n\t/**\n\t * Path relative to project root, POSIX-normalized. Used for matcher and display.\n\t * Empty string for user-home global rules.\n\t */\n\trelativePath: string;\n}\n\n/**\n * A fully-loaded rule ready for injection.\n */\nexport interface LoadedRule extends RuleCandidate {\n\tfrontmatter: RuleFrontmatter;\n\tbody: string;\n\tcontentHash: string;\n\tmatchReason: MatchReason;\n}\n\n/**\n * Source identifier for rule files. Used for deterministic ordering and display.\n */\nexport type RuleSource =\n\t| \".omo/rules\"\n\t| \".claude/rules\"\n\t| \".cursor/rules\"\n\t| \".github/instructions\"\n\t| \".github/copilot-instructions.md\"\n\t| \"AGENTS.md\"\n\t| \"CLAUDE.md\"\n\t| \"CONTEXT.md\"\n\t| \"~/.omo/rules\"\n\t| \"~/.opencode/rules\"\n\t| \"~/.claude/rules\"\n\t| \"~/.config/opencode/AGENTS.md\"\n\t| \"~/.claude/CLAUDE.md\";\n\n/**\n * Why a candidate matched the target file. Surfaced in the injection block so\n * the model can attribute its behavior to a specific rule.\n */\nexport type MatchReason = \"alwaysApply\" | \"single-file\" | { kind: \"glob\"; pattern: string } | { kind: \"no-match\" };\n\n/**\n * Truncation result.\n */\nexport interface TruncationResult {\n\tbody: string;\n\ttruncated: boolean;\n\toriginalLength: number;\n}\n\n/**\n * Configuration knobs resolved from env vars and package.json.\n */\nexport interface PiRulesConfig {\n\tdisabled: boolean;\n\tmode: \"static\" | \"dynamic\" | \"both\" | \"off\";\n\tmaxRuleChars: number;\n\tmaxResultChars: number;\n\tenabledSources: RuleSource[] | \"auto\";\n}\n\n/**\n * Per-session in-memory dedup state.\n *\n * `staticDedup` keys are `{cwd}::{rulePath}::{contentHash}` strings.\n * `dynamicDedup` stores `{targetPath}::{rulePath}::{contentHash}` strings grouped by target file.\n * `dynamicTargetFingerprints` maps a target file cache key to a digest of its\n * discovered rule candidates + file stats; loadDynamicRules short-circuits\n * targets whose fingerprint has not changed since the previous load.\n */\nexport interface SessionState {\n\tcwd: string | undefined;\n\tstaticDedup: Set<string>;\n\tdynamicDedup: Map<string, Set<string>>;\n\tdynamicTargetFingerprints: Map<string, string>;\n\tloadedRules: LoadedRule[];\n\tdiagnostics: RuleDiagnostic[];\n}\n\nexport interface RuleDiagnostic {\n\tseverity: \"warning\" | \"error\";\n\tsource: string;\n\tmessage: string;\n}\n"]}

package/dist/core/extensions/builtin/rules/ui/dynamic-border.d.ts

@@ -0,0 +1,8 @@
+import type { Component } from "@earendil-works/pi-tui";
+export declare class DynamicBorder implements Component {
+    private readonly color;
+    constructor(color: (str: string) => string);
+    render(width: number): string[];
+    invalidate(): void;
+}
+//# sourceMappingURL=dynamic-border.d.ts.map

package/dist/core/extensions/builtin/rules/ui/dynamic-border.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-border.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/rules/ui/dynamic-border.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,qBAAa,aAAc,YAAW,SAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAEhD,YAAY,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,EAEzC;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9B;IAED,UAAU,IAAI,IAAI,CAAG;CACrB"}

package/dist/core/extensions/builtin/rules/ui/dynamic-border.js

@@ -0,0 +1,10 @@
+export class DynamicBorder {
+    constructor(color) {
+        this.color = color;
+    }
+    render(width) {
+        return [this.color("─".repeat(Math.max(1, width)))];
+    }
+    invalidate() { }
+}
+//# sourceMappingURL=dynamic-border.js.map

package/dist/core/extensions/builtin/rules/ui/dynamic-border.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-border.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/rules/ui/dynamic-border.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IAGzB,YAAY,KAA8B;QACzC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,CAAC;IAED,MAAM,CAAC,KAAa;QACnB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,UAAU,KAAU,CAAC;CACrB","sourcesContent":["import type { Component } from \"@earendil-works/pi-tui\";\n\nexport class DynamicBorder implements Component {\n\tprivate readonly color: (str: string) => string;\n\n\tconstructor(color: (str: string) => string) {\n\t\tthis.color = color;\n\t}\n\n\trender(width: number): string[] {\n\t\treturn [this.color(\"─\".repeat(Math.max(1, width)))];\n\t}\n\n\tinvalidate(): void {}\n}\n"]}

package/dist/core/extensions/builtin/rules/ui/rules-banner.d.ts

@@ -0,0 +1,22 @@
+import { Container } from "@earendil-works/pi-tui";
+import type { Theme } from "../../../../../modes/interactive/theme/theme.ts";
+import type { LoadedRule, RuleDiagnostic } from "../rules/types.ts";
+export interface RulesBannerProps {
+    ruleCount: number;
+    diagnostics: ReadonlyArray<RuleDiagnostic>;
+    topRules?: ReadonlyArray<Pick<LoadedRule, "relativePath" | "matchReason">>;
+}
+export declare class RulesBanner extends Container {
+    private readonly props;
+    private readonly theme;
+    constructor(props: RulesBannerProps, theme: Theme);
+    render(width: number): string[];
+    invalidate(): void;
+}
+export declare function renderBannerLines(props: RulesBannerProps, theme: Theme, width: number): string[];
+export interface StatusLineInput {
+    ruleCount: number;
+    hasErrors: boolean;
+}
+export declare function statusLineText(input: StatusLineInput, theme: Theme): string;
+//# sourceMappingURL=rules-banner.d.ts.map

package/dist/core/extensions/builtin/rules/ui/rules-banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules-banner.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/rules/ui/rules-banner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iDAAiD,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGpE,MAAM,WAAW,gBAAgB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,GAAG,aAAa,CAAC,CAAC,CAAC;CAC3E;AAED,qBAAa,WAAY,SAAQ,SAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAE9B,YAAY,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,EAIhD;IAEQ,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvC;IAEQ,UAAU,IAAI,IAAI,CAAG;CAC9B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAuChG;AAED,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAM3E"}

package/dist/core/extensions/builtin/rules/ui/rules-banner.js

@@ -0,0 +1,51 @@
+import { Container } from "@earendil-works/pi-tui";
+import { DynamicBorder } from "./dynamic-border.js";
+export class RulesBanner extends Container {
+    constructor(props, theme) {
+        super();
+        this.props = props;
+        this.theme = theme;
+    }
+    render(width) {
+        return renderBannerLines(this.props, this.theme, width);
+    }
+    invalidate() { }
+}
+export function renderBannerLines(props, theme, width) {
+    const lines = [];
+    const border = new DynamicBorder((str) => theme.fg("border", str));
+    if (props.ruleCount === 0) {
+        lines.push(...border.render(width));
+        lines.push(`${theme.bold(theme.fg("accent", "[pi-rules]"))} No rules discovered`);
+        lines.push(...border.render(width));
+        return lines;
+    }
+    lines.push(...border.render(width));
+    lines.push(`${theme.bold(theme.fg("accent", "[pi-rules]"))} ${theme.fg("muted", `${props.ruleCount} active rules`)}`);
+    lines.push("");
+    if (props.topRules) {
+        for (const rule of props.topRules) {
+            const hasDiagnostic = props.diagnostics.some((diagnostic) => diagnostic.source === rule.relativePath);
+            const indicator = hasDiagnostic ? theme.fg("error", "⚠") : theme.fg("success", "●");
+            let annotation = "";
+            if (typeof rule.matchReason === "object" && rule.matchReason.kind === "glob") {
+                annotation = ` ${theme.fg("muted", rule.matchReason.pattern)}`;
+            }
+            lines.push(`  ${indicator} ${rule.relativePath}${annotation}`);
+        }
+    }
+    if (props.diagnostics.length > 0) {
+        lines.push(`  ${theme.fg("warning", `⚠ ${props.diagnostics.length} warning(s)`)}`);
+    }
+    lines.push("");
+    lines.push(...border.render(width));
+    return lines;
+}
+export function statusLineText(input, theme) {
+    const base = `[pi-rules] ${input.ruleCount} active`;
+    if (input.hasErrors) {
+        return theme.fg("muted", `${base} · `) + theme.fg("error", "⚠ errors");
+    }
+    return theme.fg("muted", base);
+}
+//# sourceMappingURL=rules-banner.js.map

package/dist/core/extensions/builtin/rules/ui/rules-banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules-banner.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/rules/ui/rules-banner.ts"],"names":[],"mappings":"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","sourcesContent":["import { Container } from \"@earendil-works/pi-tui\";\nimport type { Theme } from \"../../../../../modes/interactive/theme/theme.ts\";\nimport type { LoadedRule, RuleDiagnostic } from \"../rules/types.ts\";\nimport { DynamicBorder } from \"./dynamic-border.ts\";\n\nexport interface RulesBannerProps {\n\truleCount: number;\n\tdiagnostics: ReadonlyArray<RuleDiagnostic>;\n\ttopRules?: ReadonlyArray<Pick<LoadedRule, \"relativePath\" | \"matchReason\">>;\n}\n\nexport class RulesBanner extends Container {\n\tprivate readonly props: RulesBannerProps;\n\tprivate readonly theme: Theme;\n\n\tconstructor(props: RulesBannerProps, theme: Theme) {\n\t\tsuper();\n\t\tthis.props = props;\n\t\tthis.theme = theme;\n\t}\n\n\toverride render(width: number): string[] {\n\t\treturn renderBannerLines(this.props, this.theme, width);\n\t}\n\n\toverride invalidate(): void {}\n}\n\nexport function renderBannerLines(props: RulesBannerProps, theme: Theme, width: number): string[] {\n\tconst lines: string[] = [];\n\tconst border = new DynamicBorder((str) => theme.fg(\"border\", str));\n\n\tif (props.ruleCount === 0) {\n\t\tlines.push(...border.render(width));\n\t\tlines.push(`${theme.bold(theme.fg(\"accent\", \"[pi-rules]\"))} No rules discovered`);\n\t\tlines.push(...border.render(width));\n\t\treturn lines;\n\t}\n\n\tlines.push(...border.render(width));\n\tlines.push(\n\t\t`${theme.bold(theme.fg(\"accent\", \"[pi-rules]\"))} ${theme.fg(\"muted\", `${props.ruleCount} active rules`)}`,\n\t);\n\tlines.push(\"\");\n\n\tif (props.topRules) {\n\t\tfor (const rule of props.topRules) {\n\t\t\tconst hasDiagnostic = props.diagnostics.some((diagnostic) => diagnostic.source === rule.relativePath);\n\t\t\tconst indicator = hasDiagnostic ? theme.fg(\"error\", \"⚠\") : theme.fg(\"success\", \"●\");\n\n\t\t\tlet annotation = \"\";\n\t\t\tif (typeof rule.matchReason === \"object\" && rule.matchReason.kind === \"glob\") {\n\t\t\t\tannotation = ` ${theme.fg(\"muted\", rule.matchReason.pattern)}`;\n\t\t\t}\n\n\t\t\tlines.push(`  ${indicator} ${rule.relativePath}${annotation}`);\n\t\t}\n\t}\n\n\tif (props.diagnostics.length > 0) {\n\t\tlines.push(`  ${theme.fg(\"warning\", `⚠ ${props.diagnostics.length} warning(s)`)}`);\n\t}\n\n\tlines.push(\"\");\n\tlines.push(...border.render(width));\n\n\treturn lines;\n}\n\nexport interface StatusLineInput {\n\truleCount: number;\n\thasErrors: boolean;\n}\n\nexport function statusLineText(input: StatusLineInput, theme: Theme): string {\n\tconst base = `[pi-rules] ${input.ruleCount} active`;\n\tif (input.hasErrors) {\n\t\treturn theme.fg(\"muted\", `${base} · `) + theme.fg(\"error\", \"⚠ errors\");\n\t}\n\treturn theme.fg(\"muted\", base);\n}\n"]}

package/dist/core/extensions/builtin/webfetch/index.d.ts

@@ -0,0 +1,10 @@
+import type { ExtensionAPI } from "../../types.ts";
+export declare function isWebfetchEnabled(): boolean;
+/**
+ * pi-webfetch — URL retrieval for the pi coding agent.
+ *
+ * Registers one LLM-callable tool:
+ *   - webfetch — fetch URL content as markdown, text, or html.
+ */
+export default function (pi: ExtensionAPI): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/extensions/builtin/webfetch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/webfetch/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AA4BrE,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAQD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,WAAW,EAAE,EAAE,YAAY,GAAG,IAAI,CAmB/C"}

package/dist/core/extensions/builtin/webfetch/index.js

@@ -0,0 +1,53 @@
+import { renderWebfetchCall, renderWebfetchResult } from "./webfetch/renderers.js";
+import { webfetch } from "./webfetch/tool.js";
+const ENABLE_ENV = "PI_WEBFETCH";
+const STATUS_KEY = "pi-webfetch";
+const WIDGET_KEY = "pi-webfetch";
+function parseEnableEnv(envVar) {
+    const envValue = process.env[envVar];
+    if (!envValue) {
+        return true;
+    }
+    const normalized = envValue.trim().toLowerCase();
+    if (normalized === "0" || normalized === "false" || normalized === "no" || normalized === "off") {
+        return false;
+    }
+    if (normalized === "1" || normalized === "true" || normalized === "yes" || normalized === "on") {
+        return true;
+    }
+    // Unknown values fall back to default-on behavior.
+    return true;
+}
+export function isWebfetchEnabled() {
+    return parseEnableEnv(ENABLE_ENV);
+}
+function clearUi(ctx) {
+    if (!ctx.hasUI)
+        return;
+    ctx.ui.setStatus(STATUS_KEY, undefined);
+    ctx.ui.setWidget(WIDGET_KEY, undefined);
+}
+/**
+ * pi-webfetch — URL retrieval for the pi coding agent.
+ *
+ * Registers one LLM-callable tool:
+ *   - webfetch — fetch URL content as markdown, text, or html.
+ */
+export default function (pi) {
+    // When PI_WEBFETCH disables the extension, keep factory callable but skip all registration side effects.
+    if (!isWebfetchEnabled()) {
+        return;
+    }
+    pi.registerTool({
+        ...webfetch,
+        renderCall: renderWebfetchCall,
+        renderResult: renderWebfetchResult,
+    });
+    pi.on("session_start", async (_event, ctx) => {
+        clearUi(ctx);
+    });
+    pi.on("session_shutdown", async (_event, ctx) => {
+        clearUi(ctx);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/core/extensions/builtin/webfetch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/webfetch/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EAA8B,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE1E,MAAM,UAAU,GAAG,aAAa,CAAC;AACjC,MAAM,UAAU,GAAG,aAAa,CAAC;AACjC,MAAM,UAAU,GAAG,aAAa,CAAC;AAEjC,SAAS,cAAc,CAAC,MAAc;IACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACjD,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,OAAO,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QACjG,OAAO,KAAK,CAAC;IACd,CAAC;IAED,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QAChG,OAAO,IAAI,CAAC;IACb,CAAC;IAED,mDAAmD;IACnD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,MAAM,UAAU,iBAAiB;IAChC,OAAO,cAAc,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,OAAO,CAAC,GAAqB;IACrC,IAAI,CAAC,GAAG,CAAC,KAAK;QAAE,OAAO;IACvB,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACxC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,OAAO,WAAW,EAAgB;IACxC,yGAAyG;IACzG,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;QAC1B,OAAO;IACR,CAAC;IAED,EAAE,CAAC,YAAY,CAAoD;QAClE,GAAG,QAAQ;QACX,UAAU,EAAE,kBAAkB;QAC9B,YAAY,EAAE,oBAAoB;KAClC,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;QAC5C,OAAO,CAAC,GAAG,CAAC,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;QAC/C,OAAO,CAAC,GAAG,CAAC,CAAC;IACd,CAAC,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import type { ExtensionAPI, ExtensionContext } from \"../../types.ts\";\n\nimport { renderWebfetchCall, renderWebfetchResult } from \"./webfetch/renderers.ts\";\nimport { type WebfetchRenderDetails, webfetch } from \"./webfetch/tool.ts\";\n\nconst ENABLE_ENV = \"PI_WEBFETCH\";\nconst STATUS_KEY = \"pi-webfetch\";\nconst WIDGET_KEY = \"pi-webfetch\";\n\nfunction parseEnableEnv(envVar: string): boolean {\n\tconst envValue = process.env[envVar];\n\tif (!envValue) {\n\t\treturn true;\n\t}\n\n\tconst normalized = envValue.trim().toLowerCase();\n\tif (normalized === \"0\" || normalized === \"false\" || normalized === \"no\" || normalized === \"off\") {\n\t\treturn false;\n\t}\n\n\tif (normalized === \"1\" || normalized === \"true\" || normalized === \"yes\" || normalized === \"on\") {\n\t\treturn true;\n\t}\n\n\t// Unknown values fall back to default-on behavior.\n\treturn true;\n}\n\nexport function isWebfetchEnabled(): boolean {\n\treturn parseEnableEnv(ENABLE_ENV);\n}\n\nfunction clearUi(ctx: ExtensionContext): void {\n\tif (!ctx.hasUI) return;\n\tctx.ui.setStatus(STATUS_KEY, undefined);\n\tctx.ui.setWidget(WIDGET_KEY, undefined);\n}\n\n/**\n * pi-webfetch — URL retrieval for the pi coding agent.\n *\n * Registers one LLM-callable tool:\n *   - webfetch — fetch URL content as markdown, text, or html.\n */\nexport default function (pi: ExtensionAPI): void {\n\t// When PI_WEBFETCH disables the extension, keep factory callable but skip all registration side effects.\n\tif (!isWebfetchEnabled()) {\n\t\treturn;\n\t}\n\n\tpi.registerTool<typeof webfetch.parameters, WebfetchRenderDetails>({\n\t\t...webfetch,\n\t\trenderCall: renderWebfetchCall,\n\t\trenderResult: renderWebfetchResult,\n\t});\n\n\tpi.on(\"session_start\", async (_event, ctx) => {\n\t\tclearUi(ctx);\n\t});\n\n\tpi.on(\"session_shutdown\", async (_event, ctx) => {\n\t\tclearUi(ctx);\n\t});\n}\n"]}

package/dist/core/extensions/builtin/webfetch/webfetch/content.d.ts

@@ -0,0 +1,4 @@
+export declare function htmlToMarkdown(html: string): string;
+export declare function htmlToText(html: string): string;
+export declare function decodeHtmlEntities(text: string): string;
+//# sourceMappingURL=content.d.ts.map

package/dist/core/extensions/builtin/webfetch/webfetch/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/webfetch/webfetch/content.ts"],"names":[],"mappings":"AA4BA,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAa/C;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUvD"}

package/dist/core/extensions/builtin/webfetch/webfetch/content.js

@@ -0,0 +1,60 @@
+import TurndownService from "turndown";
+const TAGS_TO_REMOVE = /<(script|style|noscript|iframe|object|embed|meta|link)\b[^>]*>[\s\S]*?<\/\1>/gi;
+const VOID_TAGS_TO_REMOVE = /<(script|style|noscript|iframe|object|embed|meta|link)\b[^>]*\/?>/gi;
+const BLOCK_BREAK_TAGS = /<\/?(address|article|aside|blockquote|br|dd|div|dl|dt|figcaption|figure|footer|h[1-6]|header|hr|li|main|nav|ol|p|pre|section|table|tbody|td|tfoot|th|thead|tr|ul)\b[^>]*>/gi;
+const TAGS = /<[^>]+>/g;
+const WHITESPACE = /[\t\f\v ]+/g;
+const NEWLINE_RUN = /\n{3,}/g;
+const ENTITIES = {
+    amp: "&",
+    apos: "'",
+    gt: ">",
+    lt: "<",
+    nbsp: " ",
+    quot: '"',
+};
+const turndownService = new TurndownService({
+    headingStyle: "atx",
+    hr: "---",
+    bulletListMarker: "-",
+    codeBlockStyle: "fenced",
+    emDelimiter: "*",
+});
+turndownService.remove(["script", "style", "noscript", "iframe", "object", "embed", "meta", "link"]);
+export function htmlToMarkdown(html) {
+    return turndownService.turndown(html).trim();
+}
+export function htmlToText(html) {
+    return decodeHtmlEntities(html
+        .replace(TAGS_TO_REMOVE, "")
+        .replace(VOID_TAGS_TO_REMOVE, "")
+        .replace(BLOCK_BREAK_TAGS, "\n")
+        .replace(TAGS, "")
+        .replace(WHITESPACE, " ")
+        .replace(/[ \t]+\n/g, "\n")
+        .replace(/\n[ \t]+/g, "\n")
+        .replace(NEWLINE_RUN, "\n\n")
+        .trim());
+}
+export function decodeHtmlEntities(text) {
+    return text.replace(/&(#x[\da-f]+|#\d+|[a-z]+);/gi, (_match, entity) => {
+        if (entity.startsWith("#x")) {
+            return decodeCodePoint(Number.parseInt(entity.slice(2), 16));
+        }
+        if (entity.startsWith("#")) {
+            return decodeCodePoint(Number.parseInt(entity.slice(1), 10));
+        }
+        return ENTITIES[entity.toLowerCase()] ?? `&${entity};`;
+    });
+}
+function decodeCodePoint(value) {
+    if (!Number.isFinite(value))
+        return "";
+    try {
+        return String.fromCodePoint(value);
+    }
+    catch {
+        return "";
+    }
+}
+//# sourceMappingURL=content.js.map

package/dist/core/extensions/builtin/webfetch/webfetch/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/webfetch/webfetch/content.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,UAAU,CAAC;AAEvC,MAAM,cAAc,GAAG,gFAAgF,CAAC;AACxG,MAAM,mBAAmB,GAAG,qEAAqE,CAAC;AAClG,MAAM,gBAAgB,GACrB,6KAA6K,CAAC;AAC/K,MAAM,IAAI,GAAG,UAAU,CAAC;AACxB,MAAM,UAAU,GAAG,aAAa,CAAC;AACjC,MAAM,WAAW,GAAG,SAAS,CAAC;AAE9B,MAAM,QAAQ,GAAqC;IAClD,GAAG,EAAE,GAAG;IACR,IAAI,EAAE,GAAG;IACT,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;CACT,CAAC;AAEF,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC;IAC3C,YAAY,EAAE,KAAK;IACnB,EAAE,EAAE,KAAK;IACT,gBAAgB,EAAE,GAAG;IACrB,cAAc,EAAE,QAAQ;IACxB,WAAW,EAAE,GAAG;CAChB,CAAC,CAAC;AACH,eAAe,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAErG,MAAM,UAAU,cAAc,CAAC,IAAY;IAC1C,OAAO,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACtC,OAAO,kBAAkB,CACxB,IAAI;SACF,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;SAC3B,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;SAChC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC;SAC/B,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;SACjB,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC;SAC1B,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC;SAC1B,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC;SAC5B,IAAI,EAAE,CACR,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,8BAA8B,EAAE,CAAC,MAAM,EAAE,MAAc,EAAE,EAAE;QAC9E,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,OAAO,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,IAAI,MAAM,GAAG,CAAC;IACxD,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACrC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,IAAI,CAAC;QACJ,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,CAAC;IACX,CAAC;AACF,CAAC","sourcesContent":["import TurndownService from \"turndown\";\n\nconst TAGS_TO_REMOVE = /<(script|style|noscript|iframe|object|embed|meta|link)\\b[^>]*>[\\s\\S]*?<\\/\\1>/gi;\nconst VOID_TAGS_TO_REMOVE = /<(script|style|noscript|iframe|object|embed|meta|link)\\b[^>]*\\/?>/gi;\nconst BLOCK_BREAK_TAGS =\n\t/<\\/?(address|article|aside|blockquote|br|dd|div|dl|dt|figcaption|figure|footer|h[1-6]|header|hr|li|main|nav|ol|p|pre|section|table|tbody|td|tfoot|th|thead|tr|ul)\\b[^>]*>/gi;\nconst TAGS = /<[^>]+>/g;\nconst WHITESPACE = /[\\t\\f\\v ]+/g;\nconst NEWLINE_RUN = /\\n{3,}/g;\n\nconst ENTITIES: Readonly<Record<string, string>> = {\n\tamp: \"&\",\n\tapos: \"'\",\n\tgt: \">\",\n\tlt: \"<\",\n\tnbsp: \" \",\n\tquot: '\"',\n};\n\nconst turndownService = new TurndownService({\n\theadingStyle: \"atx\",\n\thr: \"---\",\n\tbulletListMarker: \"-\",\n\tcodeBlockStyle: \"fenced\",\n\temDelimiter: \"*\",\n});\nturndownService.remove([\"script\", \"style\", \"noscript\", \"iframe\", \"object\", \"embed\", \"meta\", \"link\"]);\n\nexport function htmlToMarkdown(html: string): string {\n\treturn turndownService.turndown(html).trim();\n}\n\nexport function htmlToText(html: string): string {\n\treturn decodeHtmlEntities(\n\t\thtml\n\t\t\t.replace(TAGS_TO_REMOVE, \"\")\n\t\t\t.replace(VOID_TAGS_TO_REMOVE, \"\")\n\t\t\t.replace(BLOCK_BREAK_TAGS, \"\\n\")\n\t\t\t.replace(TAGS, \"\")\n\t\t\t.replace(WHITESPACE, \" \")\n\t\t\t.replace(/[ \\t]+\\n/g, \"\\n\")\n\t\t\t.replace(/\\n[ \\t]+/g, \"\\n\")\n\t\t\t.replace(NEWLINE_RUN, \"\\n\\n\")\n\t\t\t.trim(),\n\t);\n}\n\nexport function decodeHtmlEntities(text: string): string {\n\treturn text.replace(/&(#x[\\da-f]+|#\\d+|[a-z]+);/gi, (_match, entity: string) => {\n\t\tif (entity.startsWith(\"#x\")) {\n\t\t\treturn decodeCodePoint(Number.parseInt(entity.slice(2), 16));\n\t\t}\n\t\tif (entity.startsWith(\"#\")) {\n\t\t\treturn decodeCodePoint(Number.parseInt(entity.slice(1), 10));\n\t\t}\n\t\treturn ENTITIES[entity.toLowerCase()] ?? `&${entity};`;\n\t});\n}\n\nfunction decodeCodePoint(value: number): string {\n\tif (!Number.isFinite(value)) return \"\";\n\ttry {\n\t\treturn String.fromCodePoint(value);\n\t} catch {\n\t\treturn \"\";\n\t}\n}\n"]}

package/dist/core/extensions/builtin/webfetch/webfetch/errors.d.ts

@@ -0,0 +1,13 @@
+export declare class InvalidWebfetchUrlError extends Error {
+    constructor(message: string);
+}
+export declare class WebfetchTimeoutError extends Error {
+    constructor(message: string);
+}
+export declare class WebfetchResponseTooLargeError extends Error {
+    constructor(message: string);
+}
+export declare class WebfetchAbortError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/extensions/builtin/webfetch/webfetch/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/webfetch/webfetch/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,uBAAwB,SAAQ,KAAK;IACjD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD;AAED,qBAAa,6BAA8B,SAAQ,KAAK;IACvD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC5C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD"}

package/dist/core/extensions/builtin/webfetch/webfetch/errors.js

@@ -0,0 +1,25 @@
+export class InvalidWebfetchUrlError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InvalidWebfetchUrlError";
+    }
+}
+export class WebfetchTimeoutError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "WebfetchTimeoutError";
+    }
+}
+export class WebfetchResponseTooLargeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "WebfetchResponseTooLargeError";
+    }
+}
+export class WebfetchAbortError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "WebfetchAbortError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/extensions/builtin/webfetch/webfetch/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/webfetch/webfetch/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACjD,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACvC,CAAC;CACD;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC9C,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACpC,CAAC;CACD;AAED,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IACvD,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC7C,CAAC;CACD;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC5C,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IAClC,CAAC;CACD","sourcesContent":["export class InvalidWebfetchUrlError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"InvalidWebfetchUrlError\";\n\t}\n}\n\nexport class WebfetchTimeoutError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"WebfetchTimeoutError\";\n\t}\n}\n\nexport class WebfetchResponseTooLargeError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"WebfetchResponseTooLargeError\";\n\t}\n}\n\nexport class WebfetchAbortError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"WebfetchAbortError\";\n\t}\n}\n"]}

package/dist/core/extensions/builtin/webfetch/webfetch/fetcher.d.ts

@@ -0,0 +1,24 @@
+export declare const MAX_RESPONSE_SIZE_BYTES: number;
+export declare const DEFAULT_TIMEOUT_SECONDS = 30;
+export declare const MAX_TIMEOUT_SECONDS = 120;
+export type WebfetchFormat = "markdown" | "text" | "html";
+export interface FetchOptions {
+    url: string;
+    format: WebfetchFormat;
+    timeoutSeconds?: number;
+    signal?: AbortSignal;
+}
+export interface FetchResult {
+    url: string;
+    status: number;
+    statusText: string;
+    contentType: string;
+    bytes: number;
+    body: Uint8Array;
+    truncated: boolean;
+}
+export declare function fetchUrl(options: FetchOptions): Promise<FetchResult>;
+export declare function validateUrl(url: string): void;
+export declare function clampTimeout(timeoutSeconds: number | undefined): number;
+export declare function buildAcceptHeader(format: WebfetchFormat): string;
+//# sourceMappingURL=fetcher.d.ts.map

package/dist/core/extensions/builtin/webfetch/webfetch/fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/webfetch/webfetch/fetcher.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,uBAAuB,QAAkB,CAAC;AACvD,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAKvC,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA+B1E;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAU7C;AAED,wBAAgB,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAIvE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAShE"}