@inixiative/foundry-core 0.5.1 → 0.5.3

package/src/index.ts

@@ -36,6 +36,7 @@ export { HttpMemory } from './adapters/http-memory';
 export {
   claudemdSource,
   formatInstructionFiles,
+  INSTRUCTION_FILE_LIMIT,
   type InstructionFile,
   type InstructionReadOptions,
   instructionImports,
@@ -116,6 +117,7 @@ export {
 } from './classifier';
 // Context primitives
 export {
+  type CompositionSnapshot,
   ContextLayer,
   type ContextLayerConfig,
   type ContextSource,
@@ -131,9 +133,13 @@ export {
   type LayerState,
   type LayerVersionMark,
   type LogicalMessageIdentity,
+  type OmittedSource,
   REQUIRED_CONTEXT_BLOCKED,
   type SourceLoadHint,
+  type SourcePart,
+  type SourceSegment,
   type SourceSelectionReport,
+  segmentsText,
   type VersionEntry,
   type VersionLog,
 } from './context-layer';
@@ -184,6 +190,94 @@ export {
   scrubSecrets,
   type TranscriptTurn,
 } from './feedback/correction';
+export {
+  DESIGN_SECTIONS,
+  type ExperimentRecord,
+  experimentProblems,
+  requireExperiment,
+  reviewPathOf,
+  TINY_MOMENTS,
+} from './feedback/experiment-gate';
+export {
+  AUTHORSHIP_MARKERS,
+  authorshipOf,
+  evidenceSnippet,
+  type FindingScope,
+  parseReviewFindings,
+  REUSE_HINT,
+  REVIEW_FINDINGS_PROMPT,
+  type ReviewFinding,
+  type ReviewMoment,
+  type ReviewReading,
+  reviewFindingMessages,
+  SCOPE_WEIGHT,
+  type SessionEvidence,
+  styleOf,
+} from './feedback/review-findings';
+export {
+  type DomainAgreement,
+  fixtureProbe,
+  labelAgreement,
+  type ParsedWardenLabels,
+  parseWardenLabels,
+  type UnlabelledFixture,
+  WARDEN_LABEL_PROMPT,
+  type WardenFixture,
+  type WardenLabel,
+  type WardenRosterEntry,
+  type WardenTriggerKind,
+  wardenLabelMessages,
+  wardenLabelPrefix,
+} from './feedback/warden-labels';
+export {
+  PREFILTER_CONTEXT_CHARS,
+  PREFILTER_DESCRIPTION_CHARS,
+  PREFILTER_MOMENT_CHARS,
+  PREFILTER_SWEEP,
+  type PrefilterPair,
+  type PrefilterPoint,
+  type PrefilterScore,
+  type PrefilterTrigger,
+  percentiles,
+  prefilterConsistency,
+  prefilterDescription,
+  prefilterQuestion,
+  prefilterSkips,
+  prefilterState,
+  scorePrefilter,
+} from './feedback/warden-prefilter';
+export {
+  type Authorship,
+  type CharterScore,
+  CONCEPT_CLUSTERS,
+  CORRECTION_TARGET_PROMPT,
+  type CorrectionTarget,
+  correctionTargetMessages,
+  MISS_KINDS,
+  type MissKind,
+  POINTER_LEVELS,
+  type PointerLevel,
+  type ProbeSource,
+  parseCorrectionTargets,
+  parseTargetCanonical,
+  parseWardenJudgement,
+  parseWardenPointerJudgement,
+  probeTriggers,
+  scoreCharterRun,
+  TARGET_CANONICAL_PROMPT,
+  targetCanonicalMessages,
+  WARDEN_JUDGE_PROMPT,
+  WARDEN_POINTER_JUDGE_PROMPT,
+  type WardenJudgement,
+  type WardenPointerJudgement,
+  type WardenProbe,
+  type WardenProbeAnswer,
+  type WardenProbeTrigger,
+  type WardenProbeTurn,
+  wardenJudgeMessage,
+  wardenPointerJudgeMessage,
+  wilsonInterval,
+} from './feedback/warden-probes';
 export {
   type FlowConfig,
   type FlowStage,
@@ -297,6 +391,8 @@ export {
   type ThreadMeta,
   type ThreadName,
   type ThreadReference,
+  type ThreadSetup,
+  type ThreadSpawn,
   type ThreadStatus,
   threadTitle,
 } from './thread';

package/src/messages.ts

@@ -1,4 +1,8 @@
-import type { LayerInstanceState, LogicalMessageIdentity } from './context-layer';
+import type {
+  CompositionSnapshot,
+  LayerInstanceState,
+  LogicalMessageIdentity,
+} from './context-layer';
 import { computeHash } from './context-layer';
 import type { AssembledContext, PromptBlock } from './context-stack';
 import type { ServedModel } from './native-evidence';
@@ -27,7 +31,7 @@ export interface InjectionBlock {
 /** One decorator's recorded participation in a turn. */
 export interface DecorationParticipant {
   readonly id: string;
-  /** contribute | abstain | error | timeout | omitted */
+  /** contribute | no-comment | skipped | error | timeout | excluded | omitted */
   readonly decision: string;
   readonly reason?: string;
   /** The three named inputs the participant worked from, never inferred. */
@@ -55,6 +59,8 @@ export type ParticipantRequest =
       readonly capturedAt: number;
       /** The model and effort that answered, when the provider answered before the phase sealed. */
       readonly served?: ServedModel;
+      /** What the call's instructions and domain knowledge were composed of; the journal stores version ids for it. */
+      readonly composition?: CompositionSnapshot;
     }
   | { readonly status: 'not-sent'; readonly phase: string; readonly reason: string }
   /** A call may have been made, but its input was never observed (e.g. the caller threw first). Not "not-sent". */

package/src/native-evidence.ts

@@ -34,6 +34,26 @@ export interface OwnedAdmissionInspection {
   readonly cleanup: 'not-requested' | 'pending' | 'released' | 'unknown';
   readonly capacity: 'settled' | 'unknown';
 }
+/** A native subagent's lifecycle event (agent-session `SubagentLifecycle`, allowlisted). */
+export interface NativeSubagentLifecycle {
+  readonly phase: 'started' | 'progress' | 'updated' | 'ended';
+  readonly taskId: string;
+  readonly toolUseId?: string;
+  readonly parentTaskId?: string;
+  readonly agentType?: string;
+  readonly description?: string;
+  readonly depth?: number;
+  readonly backgrounded?: boolean;
+  readonly status?: string;
+  readonly summary?: string;
+  readonly prompt?: string;
+  readonly usage?: {
+    readonly totalTokens: number;
+    readonly toolUses?: number;
+    readonly durationMs?: number;
+  };
+}
+
 export interface NativeEvidence {
   readonly schema: 1;
   readonly executionMode?: 'controlled-fixture';
@@ -65,6 +85,10 @@ export interface NativeEvidence {
   readonly content?: string;
   readonly correlation?: string;
   readonly kind?: string;
+  /** The parent's tool call that spawned the subagent this came from (absent for the thread's own). */
+  readonly parentToolUseId?: string;
+  /** A subagent's lifecycle (kind `subagent`), as the runtime reported it. */
+  readonly subagent?: NativeSubagentLifecycle;
   readonly toolName?: string;
   readonly toolServer?: string;
   readonly toolMethod?: string;

package/src/thread.ts

@@ -44,6 +44,21 @@ export function threadTitle(
   return meta.description ? { text: meta.description, source: 'description' } : undefined;
 }
 
+/** How a subagent thread came to be: who spawned it, through what, and its native identity. */
+export interface ThreadSpawn {
+  readonly via: 'foundry' | 'native-claude' | 'native-codex' | 'host-paseo' | 'host-t3';
+  /** The parent's tool call that spawned it. */
+  readonly toolCallId?: string;
+  /** The native run's id (Claude task id, Codex child thread id). */
+  readonly nativeTaskId?: string;
+  readonly agentType?: string;
+  readonly description?: string;
+  /** The parent's `handoff` phase row for this spawn. */
+  readonly handoffId?: string;
+  /** Recorded from the native stream only: no Foundry middleware ran on it. */
+  readonly observed?: boolean;
+}
+
 export interface ThreadMeta {
   /** Living description — what this thread is doing right now. */
   description: string;
@@ -72,6 +87,21 @@ export interface ThreadMeta {
   /** Parent thread when this thread is a subagent spawned by another. */
   parentThreadId?: string;
 
+  /** The parent's turn that spawned this thread (a subagent). */
+  parentTurnId?: string;
+
+  /** How this subagent thread was spawned (docs/reference/SUBAGENTS.md §4.1). */
+  spawn?: ThreadSpawn;
+
+  /** 1 for a child of a main thread. */
+  depth?: number;
+
+  /**
+   * Start-up of a thread whose Wardens are held in its own process (docs/THREAD-TREE.md spec C):
+   * turns typed meanwhile wait as `queued` until it is `ready` (or `degraded`).
+   */
+  setup?: ThreadSetup;
+
   /** Project that owns this thread. Scopes memory sources and tool calls. */
   projectId?: string;
 
@@ -85,6 +115,15 @@ export interface ThreadMeta {
   archivedAt?: number;
 }
 
+export interface ThreadSetup {
+  status: 'starting' | 'ready' | 'degraded';
+  startedAt: number;
+  readyAt?: number;
+  /** Every configured Warden, those holding a spare, and those that did not by the deadline. */
+  wardens: { expected: number; held: number; failed: string[] };
+  runtime: 'claude-in-session' | 'codex-in-process' | 'side-session';
+}
+
 export interface Dispatch<T = unknown> {
   readonly agentId: string;
   readonly timestamp: number;

package/src/types.ts

@@ -114,6 +114,11 @@ export interface CompletionOpts {
    * cached prefix; others ignore it. Messages are sent unchanged either way.
    */
   stablePrefix?: string;
+  /**
+   * Text right after `stablePrefix` that changes only between turns (a Warden's thread knowledge and
+   * the thread state). Providers that pre-start a call shape hold it; others ignore it.
+   */
+  threadPrefix?: string;
   /**
    * The executor's context split into standing parts and per-turn text. A provider that keeps a
    * native session delivers standing parts once and then only what changed (session-delivery.ts);
@@ -175,6 +180,13 @@ export interface LLMProvider {
   };
   complete(messages: LLMMessage[], opts?: CompletionOpts): Promise<CompletionResult>;
   stream?(messages: LLMMessage[], opts?: CompletionOpts): AsyncGenerator<LLMStreamEvent>;
+  /**
+   * Keep this call shape pre-started, so a later `complete` with the same `stablePrefix` and
+   * `threadPrefix` starts at once. `messages` end at those prefixes; no decision is made. Optional.
+   */
+  prestart?(messages: LLMMessage[], opts: CompletionOpts): void;
+  /** A thread closed: release whatever the provider holds for it. Optional. */
+  releaseThread?(threadId: string): Promise<void>;
 }
 
 export interface EmbeddingProvider {