@smthrs/harness 0.0.0-stage → 1.0.0-rc.3

package/dist/esm/VariablesPanel.js

@@ -0,0 +1,142 @@
+/**
+ * The variables panel: what the realm holds, stated every frame.
+ *
+ * A run's memory is not a JSON document the cell filed — it is the set of names
+ * the realm is holding, and the model can only act on what the prompt says about
+ * them. This is what the prompt says.
+ *
+ * Every line is a name, its type, one *cheap* size, and when it was last bound.
+ * Nothing here is serialized whole: a panel that stringified every global would
+ * pay the heap for it every frame, and the value the model wants is already
+ * under the name the panel prints.
+ *
+ * Freshness is derived from the cheap size, which is what makes the panel cost
+ * nothing. A binding rewritten to a value of the same type and the same size —
+ * a 40-character string replaced by a different 40-character string — reads as
+ * unchanged and keeps its stamp. That bound is stated rather than hidden: the
+ * panel is a roster, and the run's own prints are what say a value moved.
+ *
+ * @since 0.1.0
+ */
+import { Effect, Schema } from "effect";
+import * as CallLedger from "./CallLedger.js";
+import * as elide from "./internal/elide.js";
+import { NonNegativeSafeInt } from "./internal/nonNegativeSafeInt.js";
+/**
+ * How many names the panel prints before it starts counting instead.
+ *
+ * Sixty-four is the same order as `CallLedger` `bound` and well above what a
+ * round near par binds: the five golfed instances hold between 6 and 21 names
+ * at their last frame. A run past the bound is shown its most recently bound
+ * names and told how many older ones it still holds.
+ *
+ * @category constants
+ * @since 0.1.0
+ */
+export const bound = 64;
+/**
+ * One name the realm holds, with the cheap facts a probe can read off it.
+ *
+ * `size` is already rendered by the probe — a string's length, an array's
+ * length, an object's key count, a function's arity, a number or boolean by
+ * value — because the value itself never crosses the realm boundary.
+ *
+ * @category models
+ * @since 0.1.0
+ */
+export class Binding extends Schema.Class("flows/harness/VariablesPanel/Binding")({
+    name: Schema.String,
+    /**
+     * The name's JavaScript type, `unset` for a name a throw left unassigned, or
+     * `unreadable` for one whose value the probe could not even read — a throwing
+     * accessor, a proxy that refuses its own keys. The two are named apart because
+     * they say different things: one name holds nothing, the other holds something
+     * that will not be looked at.
+     */
+    type: Schema.String,
+    /** One cheap measure of the value, already rendered; empty when there is none. */
+    size: Schema.String
+}) {
+}
+/**
+ * One name the realm holds, with the frames that first and last bound it.
+ *
+ * @category models
+ * @since 0.1.0
+ */
+export class Stamp extends Schema.Class("flows/harness/VariablesPanel/Stamp")({
+    name: Schema.String,
+    type: Schema.String,
+    size: Schema.String,
+    /** The frame whose cell last changed the binding's cheap shape. */
+    frame: NonNegativeSafeInt,
+    /** The frame whose cell first bound the name. */
+    since: NonNegativeSafeInt
+}) {
+}
+/**
+ * Every name the realm holds, with the frames that bound it.
+ *
+ * @category models
+ * @since 0.1.0
+ */
+export const Ledger = Schema.Array(Stamp).pipe(Schema.withConstructorDefault(Effect.succeed([])), Schema.withDecodingDefaultKey(Effect.succeed([])));
+/**
+ * Re-stamps the panel against the bindings a frame closed on.
+ *
+ * A name whose type and size are unchanged keeps both of its frames, so the
+ * panel says when a binding last moved rather than that every name was touched
+ * again. A name the realm no longer reports is dropped: a `var` global cannot
+ * be deleted, so the only way a name leaves the probe's answer is the realm
+ * being rebuilt, and a roster that outlived its realm would be a lie.
+ *
+ * @category combinators
+ * @since 0.1.0
+ */
+export const stamp = (known, bindings, frame) => {
+    const previous = new Map(known.map((entry) => [entry.name, entry]));
+    return bindings.map((binding) => {
+        const before = previous.get(binding.name);
+        if (before === undefined) {
+            return new Stamp({ name: binding.name, type: binding.type, size: binding.size, frame, since: frame });
+        }
+        return before.type === binding.type && before.size === binding.size
+            ? before
+            : new Stamp({ name: binding.name, type: binding.type, size: binding.size, frame, since: before.since });
+    });
+};
+/** Names how a binding stands relative to the frame that just ran. */
+const marked = (entry, frame) => {
+    if (entry.since === frame)
+        return "new this frame";
+    if (entry.frame === frame)
+        return "changed this frame";
+    const age = frame - entry.frame;
+    return `bound at frame ${entry.frame}, ${age} frame${age === 1 ? "" : "s"} ago`;
+};
+/**
+ * Renders the panel for one frame's prompt.
+ *
+ * `frame` is the frame whose cell just ran, which is what `new` and `changed`
+ * are relative to.
+ *
+ * @category conversions
+ * @since 0.1.0
+ */
+export const render = (options) => {
+    if (options.ledger.length === 0) {
+        return "Your realm holds no names yet. Anything a cell declares at the top level is still bound in every later cell of this run.";
+    }
+    const ordered = [...options.ledger].sort((left, right) => left.frame - right.frame);
+    const listed = ordered.slice(Math.max(0, ordered.length - bound));
+    const uncounted = ordered.length - listed.length;
+    const lines = listed.map((entry) => elide.head(`- ${entry.name} (${entry.type}${entry.size === "" ? "" : `, ${entry.size}`}) — ${marked(entry, options.frame)}`, CallLedger.width, "the name is what recalls the value"));
+    return [
+        `Names your realm holds (${options.ledger.length}), least recently bound first. Read and compute with these instead of fetching them again:`,
+        ...lines,
+        ...(uncounted > 0
+            ? [`- … and ${uncounted} older name${uncounted === 1 ? "" : "s"} not listed here; they are still bound.`]
+            : [])
+    ].join("\n");
+};
+//# sourceMappingURL=VariablesPanel.js.map

package/dist/esm/VariablesPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VariablesPanel.js","sourceRoot":"","sources":["../../src/VariablesPanel.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The variables panel: what the realm holds, stated every frame.\n *\n * A run's memory is not a JSON document the cell filed — it is the set of names\n * the realm is holding, and the model can only act on what the prompt says about\n * them. This is what the prompt says.\n *\n * Every line is a name, its type, one *cheap* size, and when it was last bound.\n * Nothing here is serialized whole: a panel that stringified every global would\n * pay the heap for it every frame, and the value the model wants is already\n * under the name the panel prints.\n *\n * Freshness is derived from the cheap size, which is what makes the panel cost\n * nothing. A binding rewritten to a value of the same type and the same size —\n * a 40-character string replaced by a different 40-character string — reads as\n * unchanged and keeps its stamp. That bound is stated rather than hidden: the\n * panel is a roster, and the run's own prints are what say a value moved.\n *\n * @since 0.1.0\n */\n\nimport { Effect, Schema } from \"effect\"\nimport * as CallLedger from \"./CallLedger.ts\"\nimport * as elide from \"./internal/elide.ts\"\nimport { NonNegativeSafeInt } from \"./internal/nonNegativeSafeInt.ts\"\n\n/**\n * How many names the panel prints before it starts counting instead.\n *\n * Sixty-four is the same order as `CallLedger` `bound` and well above what a\n * round near par binds: the five golfed instances hold between 6 and 21 names\n * at their last frame. A run past the bound is shown its most recently bound\n * names and told how many older ones it still holds.\n *\n * @category constants\n * @since 0.1.0\n */\nexport const bound = 64\n\n/**\n * One name the realm holds, with the cheap facts a probe can read off it.\n *\n * `size` is already rendered by the probe — a string's length, an array's\n * length, an object's key count, a function's arity, a number or boolean by\n * value — because the value itself never crosses the realm boundary.\n *\n * @category models\n * @since 0.1.0\n */\nexport class Binding extends Schema.Class<Binding>(\"flows/harness/VariablesPanel/Binding\")({\n  name: Schema.String,\n  /**\n   * The name's JavaScript type, `unset` for a name a throw left unassigned, or\n   * `unreadable` for one whose value the probe could not even read — a throwing\n   * accessor, a proxy that refuses its own keys. The two are named apart because\n   * they say different things: one name holds nothing, the other holds something\n   * that will not be looked at.\n   */\n  type: Schema.String,\n  /** One cheap measure of the value, already rendered; empty when there is none. */\n  size: Schema.String\n}) {}\n\n/**\n * One name the realm holds, with the frames that first and last bound it.\n *\n * @category models\n * @since 0.1.0\n */\nexport class Stamp extends Schema.Class<Stamp>(\"flows/harness/VariablesPanel/Stamp\")({\n  name: Schema.String,\n  type: Schema.String,\n  size: Schema.String,\n  /** The frame whose cell last changed the binding's cheap shape. */\n  frame: NonNegativeSafeInt,\n  /** The frame whose cell first bound the name. */\n  since: NonNegativeSafeInt\n}) {}\n\n/**\n * Every name the realm holds, with the frames that bound it.\n *\n * @category models\n * @since 0.1.0\n */\nexport const Ledger = Schema.Array(Stamp).pipe(\n  Schema.withConstructorDefault(Effect.succeed<ReadonlyArray<Stamp>>([])),\n  Schema.withDecodingDefaultKey(Effect.succeed<ReadonlyArray<Stamp>>([]))\n)\n\n/**\n * Every name the realm holds, with the frames that bound it.\n *\n * @category models\n * @since 0.1.0\n */\nexport type Ledger = typeof Ledger.Type\n\n/**\n * Re-stamps the panel against the bindings a frame closed on.\n *\n * A name whose type and size are unchanged keeps both of its frames, so the\n * panel says when a binding last moved rather than that every name was touched\n * again. A name the realm no longer reports is dropped: a `var` global cannot\n * be deleted, so the only way a name leaves the probe's answer is the realm\n * being rebuilt, and a roster that outlived its realm would be a lie.\n *\n * @category combinators\n * @since 0.1.0\n */\nexport const stamp = (known: Ledger, bindings: ReadonlyArray<Binding>, frame: number): Ledger => {\n  const previous = new Map(known.map((entry) => [entry.name, entry] as const))\n  return bindings.map((binding) => {\n    const before = previous.get(binding.name)\n    if (before === undefined) {\n      return new Stamp({ name: binding.name, type: binding.type, size: binding.size, frame, since: frame })\n    }\n    return before.type === binding.type && before.size === binding.size\n      ? before\n      : new Stamp({ name: binding.name, type: binding.type, size: binding.size, frame, since: before.since })\n  })\n}\n\n/** Names how a binding stands relative to the frame that just ran. */\nconst marked = (entry: Stamp, frame: number): string => {\n  if (entry.since === frame) return \"new this frame\"\n  if (entry.frame === frame) return \"changed this frame\"\n  const age = frame - entry.frame\n  return `bound at frame ${entry.frame}, ${age} frame${age === 1 ? \"\" : \"s\"} ago`\n}\n\n/**\n * Renders the panel for one frame's prompt.\n *\n * `frame` is the frame whose cell just ran, which is what `new` and `changed`\n * are relative to.\n *\n * @category conversions\n * @since 0.1.0\n */\nexport const render = (options: {\n  readonly ledger: Ledger\n  readonly frame: number\n}): string => {\n  if (options.ledger.length === 0) {\n    return \"Your realm holds no names yet. Anything a cell declares at the top level is still bound in every later cell of this run.\"\n  }\n  const ordered = [...options.ledger].sort((left, right) => left.frame - right.frame)\n  const listed = ordered.slice(Math.max(0, ordered.length - bound))\n  const uncounted = ordered.length - listed.length\n  const lines = listed.map((entry) =>\n    elide.head(\n      `- ${entry.name} (${entry.type}${entry.size === \"\" ? \"\" : `, ${entry.size}`}) — ${marked(entry, options.frame)}`,\n      CallLedger.width,\n      \"the name is what recalls the value\"\n    )\n  )\n  return [\n    `Names your realm holds (${options.ledger.length}), least recently bound first. Read and compute with these instead of fetching them again:`,\n    ...lines,\n    ...(uncounted > 0\n      ? [`- … and ${uncounted} older name${uncounted === 1 ? \"\" : \"s\"} not listed here; they are still bound.`]\n      : [])\n  ].join(\"\\n\")\n}\n"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,172 @@
+/**
+ * @since 0.1.0
+ *
+ * `/harness` — built-in agent-loop translation contracts and pure
+ * turn helpers.
+ */
+/**
+ * @category errors
+ * @since 0.1.0
+ */
+export * as HarnessError from "./HarnessError.ts";
+/**
+ * @category events
+ * @since 0.1.0
+ */
+export * as AgentEvent from "./AgentEvent.ts";
+/**
+ * @category controls
+ * @since 1.0.0-rc.0
+ */
+export * as CompletionClaim from "./CompletionClaim.ts";
+/**
+ * @category controls
+ * @since 1.0.0-rc.0
+ */
+export * as Supervisor from "./Supervisor.ts";
+/**
+ * @category controls
+ * @since 1.0.0-rc.0
+ */
+export * as Monitor from "./Monitor.ts";
+/**
+ * @category controls
+ * @since 1.0.0-rc.0
+ */
+export * as Judgement from "./Judgement.ts";
+/**
+ * @category controls
+ * @since 1.0.0-rc.0
+ */
+export * as Relevance from "./Relevance.ts";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as Plan from "./Plan.ts";
+/**
+ * @category services
+ * @since 0.1.0
+ */
+export * as EngineLike from "./EngineLike.ts";
+/**
+ * @category utilities
+ * @since 0.1.0
+ */
+export * as Tokens from "./Tokens.ts";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as ContextWindow from "./ContextWindow.ts";
+/**
+ * @category projections
+ * @since 0.1.0
+ */
+export * as Transcript from "./Transcript.ts";
+/**
+ * @category projections
+ * @since 1.0.0-rc.1
+ */
+export * as ExternalTranscript from "./ExternalTranscript.ts";
+/**
+ * @category compaction
+ * @since 0.1.0
+ */
+export * as Compaction from "./Compaction.ts";
+/**
+ * @category steering
+ * @since 0.1.0
+ */
+export * as Steering from "./Steering.ts";
+/**
+ * @category notifications
+ * @since 0.1.0
+ */
+export * as Notifications from "./Notifications.ts";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as Cell from "./Cell.ts";
+/**
+ * @category services
+ * @since 0.1.0
+ */
+export * as Sandbox from "./Sandbox.ts";
+/**
+ * @category streams
+ * @since 0.1.0
+ */
+export * as CellTurn from "./CellTurn.ts";
+/**
+ * @category services
+ * @since 0.1.0
+ */
+export * as CellHistory from "./CellHistory.ts";
+/**
+ * @category constructors
+ * @since 0.1.0
+ */
+export * as CellCalls from "./CellCalls.ts";
+/**
+ * @category constructors
+ * @since 0.1.0
+ */
+export * as FlowBinding from "./FlowBinding.ts";
+/**
+ * @category decoding
+ * @since 0.1.0
+ */
+export * as StructuredOutput from "./StructuredOutput.ts";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as TruncatedOutput from "./TruncatedOutput.ts";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as CallLedger from "./CallLedger.ts";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as NarrowedCheck from "./NarrowedCheck.ts";
+/**
+ * @category conversions
+ * @since 0.1.0
+ */
+export * as CellValidation from "./CellValidation.ts";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as UnmovedTree from "./UnmovedTree.ts";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as UnresolvedFailure from "./UnresolvedFailure.ts";
+/**
+ * @category models
+ * @since 1.0.0-rc.1
+ */
+export * as FailedCall from "./FailedCall.ts";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as Sufficiency from "./Sufficiency.ts";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as VacuousVerification from "./VacuousVerification.ts";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as VariablesPanel from "./VariablesPanel.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AAEjD;;;GAGG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;;GAGG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;;GAGG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;;GAGG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;;GAGG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAE3C;;;GAGG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAE3C;;;GAGG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC;;;GAGG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;;GAGG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;GAGG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD;;;GAGG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;;GAGG;AACH,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAE7D;;;GAGG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;;GAGG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC;;;GAGG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD;;;GAGG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC;;;GAGG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;;GAGG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC;;;GAGG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;;GAGG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAE3C;;;GAGG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;;GAGG;AACH,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAA;AAEzD;;;GAGG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;;GAGG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;;GAGG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD;;;GAGG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;;GAGG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;;GAGG;AACH,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAE3D;;;GAGG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;;GAGG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;;GAGG;AACH,OAAO,KAAK,mBAAmB,MAAM,0BAA0B,CAAA;AAE/D;;;GAGG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA"}

package/dist/esm/index.js

@@ -0,0 +1,172 @@
+/**
+ * @since 0.1.0
+ *
+ * `/harness` — built-in agent-loop translation contracts and pure
+ * turn helpers.
+ */
+/**
+ * @category errors
+ * @since 0.1.0
+ */
+export * as HarnessError from "./HarnessError.js";
+/**
+ * @category events
+ * @since 0.1.0
+ */
+export * as AgentEvent from "./AgentEvent.js";
+/**
+ * @category controls
+ * @since 1.0.0-rc.0
+ */
+export * as CompletionClaim from "./CompletionClaim.js";
+/**
+ * @category controls
+ * @since 1.0.0-rc.0
+ */
+export * as Supervisor from "./Supervisor.js";
+/**
+ * @category controls
+ * @since 1.0.0-rc.0
+ */
+export * as Monitor from "./Monitor.js";
+/**
+ * @category controls
+ * @since 1.0.0-rc.0
+ */
+export * as Judgement from "./Judgement.js";
+/**
+ * @category controls
+ * @since 1.0.0-rc.0
+ */
+export * as Relevance from "./Relevance.js";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as Plan from "./Plan.js";
+/**
+ * @category services
+ * @since 0.1.0
+ */
+export * as EngineLike from "./EngineLike.js";
+/**
+ * @category utilities
+ * @since 0.1.0
+ */
+export * as Tokens from "./Tokens.js";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as ContextWindow from "./ContextWindow.js";
+/**
+ * @category projections
+ * @since 0.1.0
+ */
+export * as Transcript from "./Transcript.js";
+/**
+ * @category projections
+ * @since 1.0.0-rc.1
+ */
+export * as ExternalTranscript from "./ExternalTranscript.js";
+/**
+ * @category compaction
+ * @since 0.1.0
+ */
+export * as Compaction from "./Compaction.js";
+/**
+ * @category steering
+ * @since 0.1.0
+ */
+export * as Steering from "./Steering.js";
+/**
+ * @category notifications
+ * @since 0.1.0
+ */
+export * as Notifications from "./Notifications.js";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as Cell from "./Cell.js";
+/**
+ * @category services
+ * @since 0.1.0
+ */
+export * as Sandbox from "./Sandbox.js";
+/**
+ * @category streams
+ * @since 0.1.0
+ */
+export * as CellTurn from "./CellTurn.js";
+/**
+ * @category services
+ * @since 0.1.0
+ */
+export * as CellHistory from "./CellHistory.js";
+/**
+ * @category constructors
+ * @since 0.1.0
+ */
+export * as CellCalls from "./CellCalls.js";
+/**
+ * @category constructors
+ * @since 0.1.0
+ */
+export * as FlowBinding from "./FlowBinding.js";
+/**
+ * @category decoding
+ * @since 0.1.0
+ */
+export * as StructuredOutput from "./StructuredOutput.js";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as TruncatedOutput from "./TruncatedOutput.js";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as CallLedger from "./CallLedger.js";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as NarrowedCheck from "./NarrowedCheck.js";
+/**
+ * @category conversions
+ * @since 0.1.0
+ */
+export * as CellValidation from "./CellValidation.js";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as UnmovedTree from "./UnmovedTree.js";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as UnresolvedFailure from "./UnresolvedFailure.js";
+/**
+ * @category models
+ * @since 1.0.0-rc.1
+ */
+export * as FailedCall from "./FailedCall.js";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as Sufficiency from "./Sufficiency.js";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as VacuousVerification from "./VacuousVerification.js";
+/**
+ * @category models
+ * @since 0.1.0
+ */
+export * as VariablesPanel from "./VariablesPanel.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AAEjD;;;GAGG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;;GAGG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;;GAGG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;;GAGG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;;GAGG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAE3C;;;GAGG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAE3C;;;GAGG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC;;;GAGG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;;GAGG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;GAGG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD;;;GAGG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;;GAGG;AACH,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAE7D;;;GAGG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;;GAGG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC;;;GAGG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD;;;GAGG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC;;;GAGG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;;GAGG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC;;;GAGG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;;GAGG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAE3C;;;GAGG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;;GAGG;AACH,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAA;AAEzD;;;GAGG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;;GAGG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;;GAGG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD;;;GAGG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;;GAGG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;;GAGG;AACH,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAE3D;;;GAGG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;;GAGG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;;GAGG;AACH,OAAO,KAAK,mBAAmB,MAAM,0BAA0B,CAAA;AAE/D;;;GAGG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA","sourcesContent":["/**\n * @since 0.1.0\n *\n * `/harness` — built-in agent-loop translation contracts and pure\n * turn helpers.\n */\n\n/**\n * @category errors\n * @since 0.1.0\n */\nexport * as HarnessError from \"./HarnessError.ts\"\n\n/**\n * @category events\n * @since 0.1.0\n */\nexport * as AgentEvent from \"./AgentEvent.ts\"\n\n/**\n * @category controls\n * @since 1.0.0-rc.0\n */\nexport * as CompletionClaim from \"./CompletionClaim.ts\"\n\n/**\n * @category controls\n * @since 1.0.0-rc.0\n */\nexport * as Supervisor from \"./Supervisor.ts\"\n\n/**\n * @category controls\n * @since 1.0.0-rc.0\n */\nexport * as Monitor from \"./Monitor.ts\"\n\n/**\n * @category controls\n * @since 1.0.0-rc.0\n */\nexport * as Judgement from \"./Judgement.ts\"\n\n/**\n * @category controls\n * @since 1.0.0-rc.0\n */\nexport * as Relevance from \"./Relevance.ts\"\n\n/**\n * @category models\n * @since 0.1.0\n */\nexport * as Plan from \"./Plan.ts\"\n\n/**\n * @category services\n * @since 0.1.0\n */\nexport * as EngineLike from \"./EngineLike.ts\"\n\n/**\n * @category utilities\n * @since 0.1.0\n */\nexport * as Tokens from \"./Tokens.ts\"\n\n/**\n * @category models\n * @since 0.1.0\n */\nexport * as ContextWindow from \"./ContextWindow.ts\"\n\n/**\n * @category projections\n * @since 0.1.0\n */\nexport * as Transcript from \"./Transcript.ts\"\n\n/**\n * @category projections\n * @since 1.0.0-rc.1\n */\nexport * as ExternalTranscript from \"./ExternalTranscript.ts\"\n\n/**\n * @category compaction\n * @since 0.1.0\n */\nexport * as Compaction from \"./Compaction.ts\"\n\n/**\n * @category steering\n * @since 0.1.0\n */\nexport * as Steering from \"./Steering.ts\"\n\n/**\n * @category notifications\n * @since 0.1.0\n */\nexport * as Notifications from \"./Notifications.ts\"\n\n/**\n * @category models\n * @since 0.1.0\n */\nexport * as Cell from \"./Cell.ts\"\n\n/**\n * @category services\n * @since 0.1.0\n */\nexport * as Sandbox from \"./Sandbox.ts\"\n\n/**\n * @category streams\n * @since 0.1.0\n */\nexport * as CellTurn from \"./CellTurn.ts\"\n\n/**\n * @category services\n * @since 0.1.0\n */\nexport * as CellHistory from \"./CellHistory.ts\"\n\n/**\n * @category constructors\n * @since 0.1.0\n */\nexport * as CellCalls from \"./CellCalls.ts\"\n\n/**\n * @category constructors\n * @since 0.1.0\n */\nexport * as FlowBinding from \"./FlowBinding.ts\"\n\n/**\n * @category decoding\n * @since 0.1.0\n */\nexport * as StructuredOutput from \"./StructuredOutput.ts\"\n\n/**\n * @category models\n * @since 0.1.0\n */\nexport * as TruncatedOutput from \"./TruncatedOutput.ts\"\n\n/**\n * @category models\n * @since 0.1.0\n */\nexport * as CallLedger from \"./CallLedger.ts\"\n\n/**\n * @category models\n * @since 0.1.0\n */\nexport * as NarrowedCheck from \"./NarrowedCheck.ts\"\n\n/**\n * @category conversions\n * @since 0.1.0\n */\nexport * as CellValidation from \"./CellValidation.ts\"\n\n/**\n * @category models\n * @since 0.1.0\n */\nexport * as UnmovedTree from \"./UnmovedTree.ts\"\n\n/**\n * @category models\n * @since 0.1.0\n */\nexport * as UnresolvedFailure from \"./UnresolvedFailure.ts\"\n\n/**\n * @category models\n * @since 1.0.0-rc.1\n */\nexport * as FailedCall from \"./FailedCall.ts\"\n\n/**\n * @category models\n * @since 0.1.0\n */\nexport * as Sufficiency from \"./Sufficiency.ts\"\n\n/**\n * @category models\n * @since 0.1.0\n */\nexport * as VacuousVerification from \"./VacuousVerification.ts\"\n\n/**\n * @category models\n * @since 0.1.0\n */\nexport * as VariablesPanel from \"./VariablesPanel.ts\"\n"]}

package/dist/esm/internal/bytes.d.ts

@@ -0,0 +1,36 @@
+/**
+ * UTF-8 byte measurement and boundary-safe slicing.
+ *
+ * JavaScript indexes strings in UTF-16 code units, while every bound this
+ * harness presents to a model and records in a journal is stated in UTF-8
+ * bytes. These helpers keep that unit honest without ever cutting a code point
+ * into an invalid string.
+ *
+ * @since 0.1.0
+ * @private
+ */
+/**
+ * Measures a string in UTF-8 bytes.
+ *
+ * @category conversions
+ * @since 0.1.0
+ * @private
+ */
+export declare const size: (text: string) => number;
+/**
+ * Returns the longest code-point-aligned prefix no wider than `limit` UTF-8 bytes.
+ *
+ * @category conversions
+ * @since 0.1.0
+ * @private
+ */
+export declare const headSlice: (text: string, limit: number) => string;
+/**
+ * Returns the longest code-point-aligned suffix no wider than `limit` UTF-8 bytes.
+ *
+ * @category conversions
+ * @since 0.1.0
+ * @private
+ */
+export declare const tailSlice: (text: string, limit: number) => string;
+//# sourceMappingURL=bytes.d.ts.map

package/dist/esm/internal/bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../../src/internal/bytes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,KAAG,MAAyC,CAAA;AAE7E;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,KAAG,MAUvD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,KAAG,MAoBvD,CAAA"}

package/dist/esm/internal/bytes.js

@@ -0,0 +1,70 @@
+/**
+ * UTF-8 byte measurement and boundary-safe slicing.
+ *
+ * JavaScript indexes strings in UTF-16 code units, while every bound this
+ * harness presents to a model and records in a journal is stated in UTF-8
+ * bytes. These helpers keep that unit honest without ever cutting a code point
+ * into an invalid string.
+ *
+ * @since 0.1.0
+ * @private
+ */
+const encoder = new TextEncoder();
+/**
+ * Measures a string in UTF-8 bytes.
+ *
+ * @category conversions
+ * @since 0.1.0
+ * @private
+ */
+export const size = (text) => encoder.encode(text).byteLength;
+/**
+ * Returns the longest code-point-aligned prefix no wider than `limit` UTF-8 bytes.
+ *
+ * @category conversions
+ * @since 0.1.0
+ * @private
+ */
+export const headSlice = (text, limit) => {
+    let end = 0;
+    let used = 0;
+    for (const character of text) {
+        const next = used + size(character);
+        if (next > limit)
+            break;
+        used = next;
+        end = end + character.length;
+    }
+    return text.slice(0, end);
+};
+/**
+ * Returns the longest code-point-aligned suffix no wider than `limit` UTF-8 bytes.
+ *
+ * @category conversions
+ * @since 0.1.0
+ * @private
+ */
+export const tailSlice = (text, limit) => {
+    let start = text.length;
+    let used = 0;
+    // Inspect only the suffix: a large print must not allocate an array for
+    // the discarded prefix or a TextEncoder buffer for each retained character.
+    while (start > 0) {
+        const last = text.charCodeAt(start - 1);
+        let units = 1;
+        if (last >= 0xdc00 && last <= 0xdfff && start > 1) {
+            const previous = text.charCodeAt(start - 2);
+            if (previous >= 0xd800 && previous <= 0xdbff)
+                units = 2;
+        }
+        // Lone surrogates use three UTF-8 bytes, like TextEncoder's replacement.
+        const width = units === 2 ? 4 : last < 0x80 ? 1 : last < 0x800 ? 2 : 3;
+        const next = used + width;
+        if (next > limit)
+            break;
+        used = next;
+        start = start - units;
+    }
+    return text.slice(start);
+};
+//# sourceMappingURL=bytes.js.map

package/dist/esm/internal/bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.js","sourceRoot":"","sources":["../../../src/internal/bytes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;AAEjC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,CAAA;AAE7E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,KAAa,EAAU,EAAE;IAC/D,IAAI,GAAG,GAAG,CAAC,CAAA;IACX,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,KAAK,MAAM,SAAS,IAAI,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAA;QACnC,IAAI,IAAI,GAAG,KAAK;YAAE,MAAK;QACvB,IAAI,GAAG,IAAI,CAAA;QACX,GAAG,GAAG,GAAG,GAAG,SAAS,CAAC,MAAM,CAAA;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AAC3B,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,KAAa,EAAU,EAAE;IAC/D,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAA;IACvB,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,wEAAwE;IACxE,4EAA4E;IAC5E,OAAO,KAAK,GAAG,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;QACvC,IAAI,KAAK,GAAG,CAAC,CAAA;QACb,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;YAC3C,IAAI,QAAQ,IAAI,MAAM,IAAI,QAAQ,IAAI,MAAM;gBAAE,KAAK,GAAG,CAAC,CAAA;QACzD,CAAC;QACD,yEAAyE;QACzE,MAAM,KAAK,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACtE,MAAM,IAAI,GAAG,IAAI,GAAG,KAAK,CAAA;QACzB,IAAI,IAAI,GAAG,KAAK;YAAE,MAAK;QACvB,IAAI,GAAG,IAAI,CAAA;QACX,KAAK,GAAG,KAAK,GAAG,KAAK,CAAA;IACvB,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;AAC1B,CAAC,CAAA","sourcesContent":["/**\n * UTF-8 byte measurement and boundary-safe slicing.\n *\n * JavaScript indexes strings in UTF-16 code units, while every bound this\n * harness presents to a model and records in a journal is stated in UTF-8\n * bytes. These helpers keep that unit honest without ever cutting a code point\n * into an invalid string.\n *\n * @since 0.1.0\n * @private\n */\n\nconst encoder = new TextEncoder()\n\n/**\n * Measures a string in UTF-8 bytes.\n *\n * @category conversions\n * @since 0.1.0\n * @private\n */\nexport const size = (text: string): number => encoder.encode(text).byteLength\n\n/**\n * Returns the longest code-point-aligned prefix no wider than `limit` UTF-8 bytes.\n *\n * @category conversions\n * @since 0.1.0\n * @private\n */\nexport const headSlice = (text: string, limit: number): string => {\n  let end = 0\n  let used = 0\n  for (const character of text) {\n    const next = used + size(character)\n    if (next > limit) break\n    used = next\n    end = end + character.length\n  }\n  return text.slice(0, end)\n}\n\n/**\n * Returns the longest code-point-aligned suffix no wider than `limit` UTF-8 bytes.\n *\n * @category conversions\n * @since 0.1.0\n * @private\n */\nexport const tailSlice = (text: string, limit: number): string => {\n  let start = text.length\n  let used = 0\n  // Inspect only the suffix: a large print must not allocate an array for\n  // the discarded prefix or a TextEncoder buffer for each retained character.\n  while (start > 0) {\n    const last = text.charCodeAt(start - 1)\n    let units = 1\n    if (last >= 0xdc00 && last <= 0xdfff && start > 1) {\n      const previous = text.charCodeAt(start - 2)\n      if (previous >= 0xd800 && previous <= 0xdbff) units = 2\n    }\n    // Lone surrogates use three UTF-8 bytes, like TextEncoder's replacement.\n    const width = units === 2 ? 4 : last < 0x80 ? 1 : last < 0x800 ? 2 : 3\n    const next = used + width\n    if (next > limit) break\n    used = next\n    start = start - units\n  }\n  return text.slice(start)\n}\n"]}