@xenosystem/agent-interface-core 0.1.3

package/dist/capabilityTier.js

@@ -0,0 +1,120 @@
+/**
+ * Tier resolution — ADE spec §2.9, "structure comes from the substrate, not from
+ * the agent".
+ *
+ * The apparent cost of running a third-party agent in its own TUI is that it
+ * tells us nothing structured. §2.9's answer is that we should not have been
+ * asking it:
+ *
+ * > "Every run gets a sandbox. Every file write and every process spawn
+ * >  therefore passes through a boundary we own — and **a boundary you own is a
+ * >  sensor.** The sandbox is not only a wall; it is an observation plane. So the
+ * >  question is not *how do we get the agent to narrate its work*. It is *why
+ * >  are we asking the agent at all*."
+ *
+ * ## Two ways to get this wrong, and the spec names both
+ *
+ * **Understating.** §8: "Review, landing, diffs, checkpoints and the command
+ * timeline are tier-1 and therefore work for every agent in every mode,
+ * including a third-party TUI we render nothing of. **Reporting them unavailable
+ * for a third-party agent is a defect, not honest degradation — the data is in
+ * the sandbox.**"
+ *
+ * **Overstating.** §2.9: "The honest boundary: **effects are recoverable, intent
+ * is not.** Review and landing are about effects and therefore work at tier 1
+ * for every agent. Steering and reasoning capture genuinely require tier 3."
+ *
+ * So a resolver that answered "available" for everything would be as wrong as
+ * one that answered "unavailable" without a sandbox — in opposite directions,
+ * and this module is tested against both.
+ *
+ * ## There is no scraping tier
+ *
+ * §2.9: "**Explicitly excluded: parsing the TUI.** Scraping ANSI is the brittle
+ * path that breaks on every vendor UI change. We do not need it, because tier 1
+ * supplies the same facts from a source that cannot change out from under us."
+ *
+ * `CapabilityTier` therefore has no value meaning "scraped". A future
+ * contributor cannot route a capability through ANSI parsing without changing
+ * this type, which is a conversation rather than a commit.
+ */
+/**
+ * The §2.9 capability map, stated once.
+ *
+ * Kept as data rather than scattered through call sites so "is this effects or
+ * intent?" has one answer. Getting it wrong for a single capability is how a
+ * surface ends up telling a user that review is unavailable for the agent they
+ * chose — the defect §8 names.
+ */
+export const CAPABILITY_NEEDS = {
+    // Effects — recoverable from the substrate, for ANY agent, including one whose
+    // interface we render nothing of.
+    'file.changes': 'effects',
+    'review.diff': 'effects',
+    'review.hunks': 'effects',
+    'checkpoints': 'effects',
+    'command.timeline': 'effects',
+    'landing': 'effects',
+    // Intent — exists only inside the agent, and no amount of watching the
+    // filesystem recovers it.
+    'steering.mid-turn': 'intent',
+    'reasoning.capture': 'intent',
+    'permission.events': 'intent',
+    'tool.semantics': 'intent',
+};
+/**
+ * Resolves a capability to the highest tier that can actually deliver it.
+ *
+ * `available: false` is reserved for cases where NOTHING can deliver it — never
+ * used as a shorthand for "the agent did not tell us", which is the failure §8
+ * calls a defect.
+ */
+export function resolveCapabilityTier(capability, sources) {
+    const need = CAPABILITY_NEEDS[capability];
+    if (need === 'intent') {
+        // No substrate observation recovers intent. §2.9: "Steering and reasoning
+        // capture genuinely require tier 3." Answering from tier 1 here would be an
+        // invention, not a degradation.
+        if (sources.acp) {
+            return { available: true, tier: 3, reason: 'intent is only expressible over ACP' };
+        }
+        return {
+            available: false,
+            reason: 'this capability needs the agent\'s intent, which the substrate cannot observe; it requires ACP',
+        };
+    }
+    // Effects. Highest tier first — a richer source is preferred when present,
+    // because tier 3 carries semantics tier 1 has to infer.
+    if (sources.acp) {
+        return { available: true, tier: 3, reason: 'the agent reports this over ACP' };
+    }
+    if (sources.vendorSideChannel) {
+        return {
+            available: true,
+            tier: 2,
+            reason: 'a vendor-supported side channel reports this alongside the TUI',
+        };
+    }
+    if (sources.sandboxObservation) {
+        return {
+            available: true,
+            tier: 1,
+            reason: 'derived from the sandbox: every file write and process spawn crosses a boundary we own',
+        };
+    }
+    return {
+        available: false,
+        reason: 'the run has no sandbox, so its effects pass through no boundary we observe',
+    };
+}
+/**
+ * True when a capability would be wrongly reported unavailable.
+ *
+ * §8 calls that a DEFECT rather than honest degradation, so it is worth being
+ * able to assert directly — a surface can check itself instead of a human
+ * noticing that review vanished for one agent.
+ */
+export function isUnderstatedCapability(capability, sources, reportedAvailable) {
+    return resolveCapabilityTier(capability, sources).available && !reportedAvailable;
+}
+//# sourceMappingURL=capabilityTier.js.map

package/dist/capabilityTier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilityTier.js","sourceRoot":"","sources":["../src/capabilityTier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AA4BH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,+EAA+E;IAC/E,kCAAkC;IAClC,cAAc,EAAE,SAAS;IACzB,aAAa,EAAE,SAAS;IACxB,cAAc,EAAE,SAAS;IACzB,aAAa,EAAE,SAAS;IACxB,kBAAkB,EAAE,SAAS;IAC7B,SAAS,EAAE,SAAS;IACpB,uEAAuE;IACvE,0BAA0B;IAC1B,mBAAmB,EAAE,QAAQ;IAC7B,mBAAmB,EAAE,QAAQ;IAC7B,mBAAmB,EAAE,QAAQ;IAC7B,gBAAgB,EAAE,QAAQ;CACuB,CAAA;AAInD;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAA2B,EAC3B,OAA0B;IAE1B,MAAM,IAAI,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAA;IAEzC,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,0EAA0E;QAC1E,4EAA4E;QAC5E,gCAAgC;QAChC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,qCAAqC,EAAE,CAAA;QACpF,CAAC;QACD,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,MAAM,EACJ,gGAAgG;SACnG,CAAA;IACH,CAAC;IAED,2EAA2E;IAC3E,wDAAwD;IACxD,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,iCAAiC,EAAE,CAAA;IAChF,CAAC;IACD,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAC9B,OAAO;YACL,SAAS,EAAE,IAAI;YACf,IAAI,EAAE,CAAC;YACP,MAAM,EAAE,gEAAgE;SACzE,CAAA;IACH,CAAC;IACD,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;QAC/B,OAAO;YACL,SAAS,EAAE,IAAI;YACf,IAAI,EAAE,CAAC;YACP,MAAM,EACJ,wFAAwF;SAC3F,CAAA;IACH,CAAC;IACD,OAAO;QACL,SAAS,EAAE,KAAK;QAChB,MAAM,EAAE,4EAA4E;KACrF,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,UAA2B,EAC3B,OAA0B,EAC1B,iBAA0B;IAE1B,OAAO,qBAAqB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,SAAS,IAAI,CAAC,iBAAiB,CAAA;AACnF,CAAC"}

package/dist/combinationVerification.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Combination verification — ADE spec §5.7, the direct answer to context
+ * blindness.
+ *
+ * > "Run the checks against the *union* of accepted changes, not each change in
+ * >  isolation." The failure this answers is the one the research names:
+ * >  **"every agent's tests pass and the merge is still wrong."**
+ *
+ * ## Why that failure happens, stated precisely
+ *
+ * It is not that the checks are bad. It is that **each verification ran against
+ * a different input.** Run A verified {A}. Run B verified {B}. Nobody verified
+ * {A, B} — and {A, B} is what lands. Every individual result was true and the
+ * conclusion drawn from them was not.
+ *
+ * So a verification result is meaningless without the **exact set it ran
+ * against**, and this module makes that pairing unbreakable: a result carries
+ * the fingerprint of its input, and a landing gate compares that fingerprint to
+ * what is being landed. Accepting one more change invalidates every earlier
+ * result, which is the correct and slightly uncomfortable consequence.
+ *
+ * ## Unverified is not the same as failed
+ *
+ * Both refuse to land, and a gate that collapsed them would be easier to write
+ * and worse to use: "we have not checked this combination" and "we checked it
+ * and it is broken" call for completely different actions from a human. They are
+ * separate outcomes here for that reason alone.
+ */
+/** One accepted change, identified by its run and the revision of that run. */
+export interface AcceptedChange {
+    runId: string;
+    /**
+     * A token that changes whenever the run's content changes.
+     *
+     * Run id alone is NOT enough: a run that kept working after being verified is
+     * a different input wearing the same name, and that is exactly how a stale
+     * result gets trusted. The caller supplies whatever it has — an event count,
+     * a content hash, a commit sha.
+     */
+    revision: string;
+}
+/**
+ * A stable identity for a SET of accepted changes.
+ *
+ * Order-independent, because accepting A then B is the same combination as B
+ * then A, and a fingerprint that disagreed would force a needless re-run and
+ * quietly teach people to bypass the gate.
+ */
+export declare function fingerprintCombination(changes: AcceptedChange[]): string;
+export interface CombinationVerification {
+    /** The fingerprint of the set this result actually ran against. */
+    fingerprint: string;
+    passed: boolean;
+    /** What ran, for a human deciding whether to trust it. */
+    checks: string[];
+}
+export type CombinationVerdict = {
+    ok: true;
+    fingerprint: string;
+    reason: string;
+} | {
+    ok: false;
+    code: 'unverified';
+    fingerprint: string;
+    reason: string;
+} | {
+    ok: false;
+    code: 'stale';
+    fingerprint: string;
+    verifiedFingerprint: string;
+    reason: string;
+} | {
+    ok: false;
+    code: 'failed';
+    fingerprint: string;
+    failedChecks: string[];
+    reason: string;
+};
+/**
+ * Whether this combination has been verified as it stands.
+ *
+ * §5.7's gate is that the system "refuses to land on a red combination". This
+ * refuses on three distinct grounds, and keeping them distinct is the point:
+ *
+ * - **unverified** — nothing has run against this set. The honest state at the
+ *   start, and the one a naive gate reports as success.
+ * - **stale** — something ran, but against a DIFFERENT set. This is the
+ *   "every agent's tests pass and the merge is still wrong" case caught in the
+ *   act: a real green result that does not describe what is being landed.
+ * - **failed** — this exact set was checked and it is red.
+ */
+export declare function verdictForCombination(accepted: AcceptedChange[], verifications: CombinationVerification[]): CombinationVerdict;
+/**
+ * Which verifications are still meaningful after accepting more work.
+ *
+ * Returns only those matching the new fingerprint — everything else described a
+ * combination that no longer exists. Discarding rather than downgrading is
+ * deliberate: a "probably still fine" result is the one someone lands on.
+ */
+export declare function pruneStaleVerifications(accepted: AcceptedChange[], verifications: CombinationVerification[]): CombinationVerification[];
+//# sourceMappingURL=combinationVerification.d.ts.map

package/dist/combinationVerification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combinationVerification.d.ts","sourceRoot":"","sources":["../src/combinationVerification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb;;;;;;;OAOG;IACH,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAYxE;AAED,MAAM,WAAW,uBAAuB;IACtC,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,OAAO,CAAA;IACf,0DAA0D;IAC1D,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9F;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAE9F;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,cAAc,EAAE,EAC1B,aAAa,EAAE,uBAAuB,EAAE,GACvC,kBAAkB,CA4CpB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,cAAc,EAAE,EAC1B,aAAa,EAAE,uBAAuB,EAAE,GACvC,uBAAuB,EAAE,CAG3B"}

package/dist/combinationVerification.js

@@ -0,0 +1,115 @@
+/**
+ * Combination verification — ADE spec §5.7, the direct answer to context
+ * blindness.
+ *
+ * > "Run the checks against the *union* of accepted changes, not each change in
+ * >  isolation." The failure this answers is the one the research names:
+ * >  **"every agent's tests pass and the merge is still wrong."**
+ *
+ * ## Why that failure happens, stated precisely
+ *
+ * It is not that the checks are bad. It is that **each verification ran against
+ * a different input.** Run A verified {A}. Run B verified {B}. Nobody verified
+ * {A, B} — and {A, B} is what lands. Every individual result was true and the
+ * conclusion drawn from them was not.
+ *
+ * So a verification result is meaningless without the **exact set it ran
+ * against**, and this module makes that pairing unbreakable: a result carries
+ * the fingerprint of its input, and a landing gate compares that fingerprint to
+ * what is being landed. Accepting one more change invalidates every earlier
+ * result, which is the correct and slightly uncomfortable consequence.
+ *
+ * ## Unverified is not the same as failed
+ *
+ * Both refuse to land, and a gate that collapsed them would be easier to write
+ * and worse to use: "we have not checked this combination" and "we checked it
+ * and it is broken" call for completely different actions from a human. They are
+ * separate outcomes here for that reason alone.
+ */
+/**
+ * A stable identity for a SET of accepted changes.
+ *
+ * Order-independent, because accepting A then B is the same combination as B
+ * then A, and a fingerprint that disagreed would force a needless re-run and
+ * quietly teach people to bypass the gate.
+ */
+export function fingerprintCombination(changes) {
+    if (changes.length === 0)
+        return 'empty';
+    const seen = new Map();
+    for (const change of changes) {
+        // Last revision wins: re-accepting a run after more work replaces the older
+        // entry rather than producing a set containing the run twice.
+        seen.set(change.runId, change.revision);
+    }
+    return [...seen.entries()]
+        .map(([runId, revision]) => `${runId}@${revision}`)
+        .sort()
+        .join('+');
+}
+/**
+ * Whether this combination has been verified as it stands.
+ *
+ * §5.7's gate is that the system "refuses to land on a red combination". This
+ * refuses on three distinct grounds, and keeping them distinct is the point:
+ *
+ * - **unverified** — nothing has run against this set. The honest state at the
+ *   start, and the one a naive gate reports as success.
+ * - **stale** — something ran, but against a DIFFERENT set. This is the
+ *   "every agent's tests pass and the merge is still wrong" case caught in the
+ *   act: a real green result that does not describe what is being landed.
+ * - **failed** — this exact set was checked and it is red.
+ */
+export function verdictForCombination(accepted, verifications) {
+    const fingerprint = fingerprintCombination(accepted);
+    const matching = verifications.filter((verification) => verification.fingerprint === fingerprint);
+    if (matching.length === 0) {
+        // Naming the nearest thing that DID run turns "no" into something a human
+        // can act on, rather than leaving them to guess whether anything ran at all.
+        const nearest = verifications.at(-1);
+        if (nearest) {
+            return {
+                ok: false,
+                code: 'stale',
+                fingerprint,
+                verifiedFingerprint: nearest.fingerprint,
+                reason: 'the checks that passed ran against a different combination; every individual result can be true while the union is still wrong',
+            };
+        }
+        return {
+            ok: false,
+            code: 'unverified',
+            fingerprint,
+            reason: 'no checks have run against this combination',
+        };
+    }
+    // A single red result decides it. Taking the most recent instead would let a
+    // re-run that skipped a check overwrite a real failure.
+    const failed = matching.filter((verification) => !verification.passed);
+    if (failed.length > 0) {
+        return {
+            ok: false,
+            code: 'failed',
+            fingerprint,
+            failedChecks: [...new Set(failed.flatMap((verification) => verification.checks))].sort(),
+            reason: 'this combination was checked and it is red',
+        };
+    }
+    return {
+        ok: true,
+        fingerprint,
+        reason: 'the checks ran against exactly this combination and passed',
+    };
+}
+/**
+ * Which verifications are still meaningful after accepting more work.
+ *
+ * Returns only those matching the new fingerprint — everything else described a
+ * combination that no longer exists. Discarding rather than downgrading is
+ * deliberate: a "probably still fine" result is the one someone lands on.
+ */
+export function pruneStaleVerifications(accepted, verifications) {
+    const fingerprint = fingerprintCombination(accepted);
+    return verifications.filter((verification) => verification.fingerprint === fingerprint);
+}
+//# sourceMappingURL=combinationVerification.js.map

package/dist/combinationVerification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"combinationVerification.js","sourceRoot":"","sources":["../src/combinationVerification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAgBH;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAyB;IAC9D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAA;IACxC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAA;IACtC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,4EAA4E;QAC5E,8DAA8D;QAC9D,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;IACzC,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;SACvB,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,QAAQ,EAAE,CAAC;SAClD,IAAI,EAAE;SACN,IAAI,CAAC,GAAG,CAAC,CAAA;AACd,CAAC;AAgBD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAA0B,EAC1B,aAAwC;IAExC,MAAM,WAAW,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAA;IACpD,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,WAAW,KAAK,WAAW,CAAC,CAAA;IAEjG,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,0EAA0E;QAC1E,6EAA6E;QAC7E,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QACpC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,OAAO;gBACb,WAAW;gBACX,mBAAmB,EAAE,OAAO,CAAC,WAAW;gBACxC,MAAM,EACJ,gIAAgI;aACnI,CAAA;QACH,CAAC;QACD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,YAAY;YAClB,WAAW;YACX,MAAM,EAAE,6CAA6C;SACtD,CAAA;IACH,CAAC;IAED,6EAA6E;IAC7E,wDAAwD;IACxD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;IACtE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,QAAQ;YACd,WAAW;YACX,YAAY,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;YACxF,MAAM,EAAE,4CAA4C;SACrD,CAAA;IACH,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,WAAW;QACX,MAAM,EAAE,4DAA4D;KACrE,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAA0B,EAC1B,aAAwC;IAExC,MAAM,WAAW,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAA;IACpD,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,WAAW,KAAK,WAAW,CAAC,CAAA;AACzF,CAAC"}

package/dist/context/agentAttachedContextPrompt.d.ts

@@ -0,0 +1,13 @@
+interface PromptAttachment {
+    name: string;
+    type: string;
+}
+interface BuildRuntimeAttachedContextPromptInput {
+    text: string;
+    attachments?: PromptAttachment[];
+    codeContextPrompt?: string;
+    searchAttachments?: unknown[];
+}
+export declare function buildRuntimeAttachedContextPrompt(input: BuildRuntimeAttachedContextPromptInput): string;
+export {};
+//# sourceMappingURL=agentAttachedContextPrompt.d.ts.map

package/dist/context/agentAttachedContextPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentAttachedContextPrompt.d.ts","sourceRoot":"","sources":["../../src/context/agentAttachedContextPrompt.ts"],"names":[],"mappings":"AAAA,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,UAAU,sCAAsC;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,iBAAiB,CAAC,EAAE,OAAO,EAAE,CAAA;CAC9B;AA2BD,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,sCAAsC,GAAG,MAAM,CAwBvG"}

package/dist/context/agentAttachedContextPrompt.js

@@ -0,0 +1,50 @@
+const SECRET_TEXT_PATTERN = /\b(sk-[A-Za-z0-9_-]{12,}|xai-[A-Za-z0-9_-]{12,}|BSA[A-Za-z0-9_-]{12,})\b/g;
+const BEARER_TEXT_PATTERN = /\b(Bearer\s+)[A-Za-z0-9._~+/=-]{12,}/gi;
+const SECRET_ASSIGNMENT_PATTERN = /(["']?(?:api[_-]?key|access[_-]?token|refresh[_-]?token|id[_-]?token|auth[_-]?token|bearer[_-]?token|secret|password|authorization|cookie|credential|credentials)["']?\s*[:=]\s*["']?)[^"',\s}]+/gi;
+function truncateForPrompt(text, maxChars) {
+    if (!text)
+        return '';
+    if (text.length <= maxChars)
+        return text;
+    return `${text.slice(0, maxChars)}\n...[truncated]`;
+}
+function redactPromptText(text) {
+    return text
+        .replace(SECRET_TEXT_PATTERN, '[redacted-api-key]')
+        .replace(BEARER_TEXT_PATTERN, '$1[redacted-token]')
+        .replace(SECRET_ASSIGNMENT_PATTERN, '$1[redacted]');
+}
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+function readPromptString(value, maxChars) {
+    return redactPromptText(typeof value === 'string' ? truncateForPrompt(value.trim(), maxChars) : '');
+}
+export function buildRuntimeAttachedContextPrompt(input) {
+    const blocks = [input.text];
+    const attachments = input.attachments || [];
+    if (attachments.length > 0) {
+        blocks.push(`Attached files:\n${attachments.slice(0, 12).map((attachment) => `- ${attachment.name} (${attachment.type})`).join('\n')}`);
+    }
+    const codeContext = readPromptString(input.codeContextPrompt, 12_000);
+    if (codeContext)
+        blocks.push(`Attached code context:\n${codeContext}`);
+    const searchContext = (input.searchAttachments || [])
+        .slice(0, 8)
+        .map((attachment) => {
+        const record = asRecord(attachment);
+        const acl = asRecord(record.aclSnapshot);
+        const source = readPromptString(record.sourceConversationId, 160) || 'attached conversation';
+        const summary = readPromptString(record.summary, 2200);
+        const tokenEstimate = typeof record.tokenEstimate === 'number' ? `, ~${record.tokenEstimate} tokens` : '';
+        const visibility = readPromptString(acl.visibility, 80);
+        const aclText = visibility ? `, ACL ${visibility}` : '';
+        return summary ? `- ${source}${tokenEstimate}${aclText}:\n${summary}` : '';
+    })
+        .filter(Boolean)
+        .join('\n\n');
+    if (searchContext)
+        blocks.push(`Attached search context:\n${searchContext}`);
+    return blocks.filter((block) => block.trim()).join('\n\n');
+}
+//# sourceMappingURL=agentAttachedContextPrompt.js.map

package/dist/context/agentAttachedContextPrompt.js.map

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

package/dist/context/agentModelContext.d.ts

@@ -0,0 +1,77 @@
+export interface AgentModelContextToolCall {
+    toolName: string;
+    params?: Record<string, unknown>;
+    result?: string;
+    success?: boolean;
+    status?: 'running' | 'done';
+    summary?: string;
+    cwd?: string;
+    artifacts?: Array<{
+        type: string;
+        label: string;
+        value: string;
+    }>;
+}
+export interface AgentModelContextMessage {
+    id?: string;
+    role: 'user' | 'assistant';
+    content: string;
+    timestamp?: number;
+    toolCalls?: AgentModelContextToolCall[];
+    attachments?: Array<{
+        name: string;
+    }>;
+}
+export interface AgentModelContextWorkspaceState {
+    workspaceName?: string;
+    teamName?: string;
+    agentName?: string;
+    rootDirectory?: string;
+    grantedDirectories?: string[];
+    activeTasks?: Array<{
+        text: string;
+        status?: string;
+    }>;
+    checkpoints?: Array<{
+        name: string;
+        createdAt?: number;
+    }>;
+}
+export interface AgentModelContextStats {
+    strategyVersion: number;
+    contextDigest: string;
+    rawMessageCount: number;
+    sentMessageCount: number;
+    compactedMessageCount: number;
+    rawCharacterCount: number;
+    sentCharacterCount: number;
+    estimatedRawTokens: number;
+    estimatedSentTokens: number;
+    retainedCompactedMessageCount: number;
+    retainedAnchorCount: number;
+    retainedArtifactCount: number;
+    retainedGrantedDirectoryCount: number;
+}
+export declare const AGENT_MODEL_CONTEXT_STRATEGY_VERSION = 1;
+export interface AgentModelContextResult {
+    messages: Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>;
+    systemPromptContext: string;
+    stats: AgentModelContextStats;
+}
+interface BuildAgentModelContextOptions {
+    messages: AgentModelContextMessage[];
+    workspaceState?: AgentModelContextWorkspaceState;
+    hotMessageCount?: number;
+    maxHotMessageCharacters?: number;
+    maxLatestMessageCharacters?: number;
+    maxSystemContextCharacters?: number;
+    maxLedgerItems?: number;
+    maxColdMemoryItems?: number;
+}
+export declare function appendAgentModelContextToSystemPrompt(systemPrompt: string | undefined, systemPromptContext: string): string | undefined;
+export declare function buildAgentModelContext(options: BuildAgentModelContextOptions): AgentModelContextResult;
+export {};
+//# sourceMappingURL=agentModelContext.d.ts.map

package/dist/context/agentModelContext.d.ts.map

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