@inixiative/foundry-core 0.5.11 → 0.5.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inixiative/foundry-core",
-  "version": "0.5.11",
+  "version": "0.5.13",
   "type": "module",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -33,7 +33,7 @@
     "bun": ">=1.4.4"
   },
   "peerDependencies": {
-    "@inixiative/archive": "^0.33.0"
+    "@inixiative/archive": "^0.34.0"
   },
   "peerDependenciesMeta": {
     "@inixiative/archive": {
@@ -41,6 +41,6 @@
     }
   },
   "devDependencies": {
-    "@inixiative/archive": "^0.33.1"
+    "@inixiative/archive": "^0.34.0"
   }
 }

package/src/adapters/markdown-hierarchy.ts

@@ -37,7 +37,7 @@ export interface HierarchyMatch {
   readonly owners?: readonly string[];
   /** The harness the composed prompt is for. */
   readonly harness?: readonly string[];
-  /** The role composed for (e.g. "main", a Warden's agent id). */
+  /** The role composed for (e.g. a thread role, a Warden's agent id), or one of its base roles. */
   readonly roles?: readonly string[];
   /** The slot composed (e.g. "instructions", "domainKnowledge"). */
   readonly slots?: readonly string[];
@@ -124,6 +124,11 @@ export interface HierarchyLocation {
   readonly harnessLoads?: readonly string[];
   /** The role composed for; also `{role}` in paths. */
   readonly role?: string;
+  /**
+   * Roles whose files come first: a source whose path names `{role}` is read once per base role, in
+   * order, then for `role` (e.g. a shared base role under each thread role).
+   */
+  readonly baseRoles?: readonly string[];
   /** The slot composed; also `{slot}` in paths. */
   readonly slot?: string;
   /**
@@ -221,7 +226,14 @@ function matches(when: HierarchyMatch | undefined, location: HierarchyLocation):
   if (when.projects && !(location.projectId && when.projects.includes(location.projectId)))
     return false;
   if (when.owners && !(location.owner && when.owners.includes(location.owner))) return false;
-  if (when.roles && !(location.role && when.roles.includes(location.role))) return false;
+  // A base role counts as the role it sits under (a node for `main` serves every thread role).
+  if (
+    when.roles &&
+    ![...(location.baseRoles ?? []), ...(location.role ? [location.role] : [])].some((role) =>
+      when.roles!.includes(role),
+    )
+  )
+    return false;
   if (when.slots && !(location.slot && when.slots.includes(location.slot))) return false;
   if (when.paths && !matchedPath(when.paths, location)) return false;
   return true;
@@ -480,6 +492,22 @@ export async function discoverHierarchy(
   ) => {
     if (!matches(source.when, location) || (source.id && loadedNatively.has(source.id))) return;
     if (!slotted && !source.when?.slots && !unslottedApplies(entry.node, location)) return;
+    const templates = typeof source.path === 'string' ? [source.path] : source.path;
+    const roles =
+      location.baseRoles?.length && templates.some((path) => path.includes('{role}'))
+        ? [...new Set([...location.baseRoles, ...(location.role ? [location.role] : [])])]
+        : undefined;
+    for (const pass of roles ? roles.map((role) => ({ ...vars, role })) : [vars])
+      await collect(entry, source, position, base, pass);
+  };
+
+  const collect = async (
+    entry: SelectedHierarchyNode,
+    source: HierarchyFileSource,
+    position: number,
+    base: string | undefined,
+    vars: Readonly<Record<string, string | undefined>>,
+  ) => {
     const place = (path: string) => (isAbsolute(path) ? path : base ? join(base, path) : undefined);
     const literal = (template: string) => {
       const expanded = expandHierarchyPath(template, vars, location.home);

package/src/event-stream.ts

@@ -42,7 +42,31 @@ export type StreamEvent =
       message: string;
       severity: 'error' | 'warn';
       timestamp: number;
-    };
+    }
+  | ({ kind: 'activity'; timestamp: number } & SystemActivity);
+
+export type ActivityEvent = Extract<StreamEvent, { kind: 'activity' }>;
+
+/**
+ * What the system is doing around a thread, not in it (Aron, 2026-11-11): a project's Wardens
+ * starting, a decision process restarting, a rate limit. The viewer keeps the latest per `key`
+ * and shows it above the composer; `error` events stay for what failed and needs the person.
+ */
+export interface SystemActivity {
+  /** One thing that changes over time ("project-wardens:<projectId>"); a later event replaces it. */
+  readonly key: string;
+  readonly source: string;
+  /** The project it concerns; absent when it touches every thread (a login's rate limit). */
+  readonly projectId?: string;
+  /** `idle` is kept for the log only; the others show, in the status colours. */
+  readonly state: 'working' | 'ready' | 'degraded' | 'failed' | 'idle';
+  /** Shown until then unless a later event of the same key replaces it (a rate limit's end). */
+  readonly until?: number;
+  /** One plain sentence for the person. */
+  readonly summary: string;
+  /** The technical line, for the expanded log. */
+  readonly detail: string;
+}
 
 /**
  * Unified event stream across all threads and sessions.
@@ -56,6 +80,8 @@ export type StreamEvent =
 export class EventStream {
   private _listeners: Array<(event: StreamEvent) => void> = [];
   private _history: StreamEvent[] = [];
+  /** The latest activity of each key, kept past the history bound: a failure stays until it clears. */
+  private _activities = new Map<string, ActivityEvent>();
   private _maxHistory: number;
 
   constructor(maxHistory: number = 5000) {
@@ -64,6 +90,10 @@ export class EventStream {
 
   /** Push an event into the stream. */
   push(event: StreamEvent): void {
+    if (event.kind === 'activity') {
+      this._activities.delete(event.key);
+      this._activities.set(event.key, event);
+    }
     this._history.push(event);
     if (this._history.length > this._maxHistory) {
       this._history.shift();
@@ -117,8 +147,19 @@ export class EventStream {
     this.push({ kind: 'error', source, message, severity, timestamp: Date.now() });
   }
 
+  /** Push what the system is doing (shown above the composer, never as a toast). */
+  pushActivity(activity: SystemActivity): void {
+    this.push({ kind: 'activity', ...activity, timestamp: Date.now() });
+  }
+
+  /** The latest activity of every key, oldest first. */
+  activities(): ActivityEvent[] {
+    return [...this._activities.values()];
+  }
+
   /** Clear history. */
   clear(): void {
     this._history = [];
+    this._activities.clear();
   }
 }

package/src/index.ts

@@ -166,7 +166,13 @@ export {
   verifyExpertDelivery,
 } from './delivery-evidence';
 // Observability
-export { EventStream, type SessionEvent, type StreamEvent } from './event-stream';
+export {
+  type ActivityEvent,
+  EventStream,
+  type SessionEvent,
+  type StreamEvent,
+  type SystemActivity,
+} from './event-stream';
 export {
   type ExecuteHandler,
   type ExecuteMeta,
@@ -412,6 +418,8 @@ export {
   type FanResult,
   Thread,
   type ThreadAgentStatus,
+  type ThreadArtifact,
+  type ThreadArtifactKind,
   type ThreadCheckout,
   type ThreadConfig,
   type ThreadContext,

package/src/model-registry.ts

@@ -245,7 +245,7 @@ export interface ModelSweepOption {
   label: string;
 }
 
-export const MODEL_REGISTRY_UPDATED_AT = '2026-09-24';
+export const MODEL_REGISTRY_UPDATED_AT = '2026-11-11';
 
 /**
  * Decision default: Claude Haiku 5.5, the cheapest current Claude model tagged `judgment`. Held here
@@ -292,7 +292,7 @@ export const MODEL_REGISTRY: Record<string, FoundryProviderInfo> = {
     models: [
       {
         id: 'fable',
-        label: 'Fable 5.1',
+        label: 'Fable 5.2',
         tier: 'powerful',
         costTier: 'high',
         contextWindow: 1_000_000,
@@ -301,7 +301,7 @@ export const MODEL_REGISTRY: Record<string, FoundryProviderInfo> = {
         nativeAlias: true,
         capabilities: POWERFUL_REASONING,
         reasoning: CLAUDE_REASONING,
-        notes: 'Claude Code alias for claude-fable-5-1.',
+        notes: 'Claude Code alias for claude-fable-5-2.',
       },
       {
         id: 'opus',
@@ -348,6 +348,17 @@ export const MODEL_REGISTRY: Record<string, FoundryProviderInfo> = {
         capabilities: POWERFUL_REASONING,
         reasoning: CLAUDE_REASONING,
       },
+      {
+        id: 'claude-fable-5-2',
+        label: 'Fable 5.2',
+        tier: 'powerful',
+        costTier: 'high',
+        contextWindow: 1_000_000,
+        maxOutputTokens: 128_000,
+        runtimeKind: 'native-harness',
+        capabilities: POWERFUL_REASONING,
+        reasoning: CLAUDE_REASONING,
+      },
       {
         id: 'claude-fable-5-1',
         label: 'Fable 5.1',
@@ -382,6 +393,18 @@ export const MODEL_REGISTRY: Record<string, FoundryProviderInfo> = {
     credential: 'api-key',
     enabledByDefault: true,
     models: [
+      {
+        id: 'claude-fable-5-2',
+        label: 'Claude Fable 5.2',
+        tier: 'powerful',
+        costTier: 'high',
+        contextWindow: 1_000_000,
+        maxOutputTokens: 128_000,
+        runtimeKind: 'api',
+        capabilities: POWERFUL_REASONING,
+        reasoning: CLAUDE_REASONING,
+        notes: 'Thinking is always on; steer with effort.',
+      },
       {
         id: 'claude-fable-5-1',
         label: 'Claude Fable 5.1',
@@ -416,6 +439,17 @@ export const MODEL_REGISTRY: Record<string, FoundryProviderInfo> = {
         capabilities: POWERFUL_REASONING,
         reasoning: CLAUDE_REASONING,
       },
+      {
+        id: 'claude-sonnet-5-5',
+        label: 'Claude Sonnet 5.5',
+        tier: 'standard',
+        costTier: 'medium',
+        contextWindow: 1_000_000,
+        maxOutputTokens: 128_000,
+        runtimeKind: 'api',
+        capabilities: STANDARD_REASONING,
+        reasoning: CLAUDE_REASONING,
+      },
       {
         id: 'claude-sonnet-5',
         label: 'Claude Sonnet 5',

package/src/scope.ts

@@ -16,6 +16,10 @@ export interface OwnershipScope {
   readonly projectId?: string;
   /** Where the thread's native session runs. Not ownership: sources that read the workspace resolve against it. */
   readonly cwd?: string;
+  /** The thread role it composes as; absent: its worker's default. Not ownership. */
+  readonly role?: string;
+  /** The worker running its main session. Not ownership. */
+  readonly worker?: string;
 }
 
 /** Copy a scope, dropping undefined fields so equality checks are stable. */

package/src/thread.ts

@@ -68,7 +68,7 @@ export interface ThreadPlanItem {
 
 /**
  * The thread's plan, written by its agent through Foundry's `set_plan` tool. Outcomes are what the
- * person gets (`you`: waits on the person); pains what hurts today; strategy how the work goes;
+ * person gets (`you`: waits on the person, shown in Plan, never Attention); pains what hurts today; strategy how the work goes;
  * reasons why this way. Each technical row names, per concern (auth, permissions, db access,
  * requests, locks, jobs, events, errors…), the existing system it uses and where, or why none fits.
  */
@@ -95,6 +95,26 @@ export interface ThreadPlan {
   readonly updatedAt: number;
 }
 
+/** How an artifact renders: Markdown, a Mermaid diagram, an HTML page (scripts run sandboxed) or code. */
+export type ThreadArtifactKind = 'markdown' | 'mermaid' | 'html' | 'code';
+
+/**
+ * One artifact the thread's agent made with `set_artifact`, as the thread lists it: what it is and
+ * its versions. The content of each version is a journal row (`artifact` phase), read on demand.
+ */
+export interface ThreadArtifact {
+  readonly id: string;
+  readonly title: string;
+  readonly kind: ThreadArtifactKind;
+  readonly versions: readonly {
+    readonly version: number;
+    /** The turn that wrote it, when one was running: the conversation shows its card there. */
+    readonly turnId: string | null;
+    readonly at: number;
+  }[];
+  readonly updatedAt: number;
+}
+
 /** One round of a thread's loop: how it went and what it found. */
 export interface ThreadLoopRound {
   readonly round: number;
@@ -241,6 +261,8 @@ export interface ThreadMeta {
   plan?: ThreadPlan;
   /** The process the agent repeats to reach the plan (`set_loop`, the Loop view). */
   loop?: ThreadLoop;
+  /** What the agent made to show the person (`set_artifact`, the Artifacts view), newest last. */
+  artifacts?: ThreadArtifact[];
   /** Where the agent says it stands: waiting on the person or blocked (`set_status`). */
   agentStatus?: ThreadAgentStatus;
   /** The machine (Foundry device identity, `~/.foundry/device.json`) the thread runs on. */
@@ -282,6 +304,9 @@ export interface ThreadMeta {
   /** The harness running this thread's main session (`claude-code`, `codex`). Set at creation; never changed silently. */
   worker?: string;
 
+  /** The thread role its instructions compose as (`coder`, `assistant`, …). Absent: its worker's default role. */
+  role?: string;
+
   /** When this thread was created. */
   readonly createdAt: number;
 
@@ -388,6 +413,8 @@ export interface ThreadConfig {
   projectId?: string;
   /** The harness running this thread's main session. */
   worker?: string;
+  /** The thread role its instructions compose as. */
+  role?: string;
   /** Optional token tracker — auto-records costs for every dispatch. */
   tokenTracker?: TokenTracker;
 }
@@ -441,6 +468,7 @@ export class Thread {
       ...(opts?.forkedFrom ? { forkedFrom: opts.forkedFrom } : {}),
       projectId: opts?.projectId,
       ...(opts?.worker ? { worker: opts.worker } : {}),
+      ...(opts?.role ? { role: opts.role } : {}),
       createdAt: now,
       lastActiveAt: now,
     };

package/src/token-tracker.ts

@@ -219,18 +219,19 @@ export interface UsageSummary {
 
 // ---------------------------------------------------------------------------
 // Default cost table. Anthropic: first-party API list prices per 1M tokens, as published at
-// https://platform.claude.com/docs/en/about-claude/pricing (read 2026-11-01; cache writes are the
+// https://platform.claude.com/docs/en/about-claude/pricing (read 2026-11-11; cache writes are the
 // 5-minute rate, 1.25x input). Haiku 5.5 is its rate up to 100K-token prompts.
 // ---------------------------------------------------------------------------
 
 export const DEFAULT_COST_TABLE: CostTable = {
   anthropic: {
+    'claude-fable-5-2': { inputPer1M: 8, outputPer1M: 40, cacheReadPer1M: 0.2 },
     'claude-fable-5-1': { inputPer1M: 10, outputPer1M: 50, cacheReadPer1M: 0.25 },
     'claude-fable-5': { inputPer1M: 10, outputPer1M: 50 },
     'claude-opus-5-5': { inputPer1M: 4, outputPer1M: 20, cacheReadPer1M: 0.2 },
     'claude-opus-5': { inputPer1M: 5, outputPer1M: 25 },
     'claude-opus-4-8': { inputPer1M: 5, outputPer1M: 25 },
-    'claude-sonnet-5-5': { inputPer1M: 2, outputPer1M: 10, cacheReadPer1M: 0.2 },
+    'claude-sonnet-5-5': { inputPer1M: 2, outputPer1M: 10, cacheReadPer1M: 0.1 },
     'claude-sonnet-5': { inputPer1M: 2, outputPer1M: 10 },
     'claude-haiku-5-5': { inputPer1M: 0.1, outputPer1M: 0.5 },
     'claude-haiku-4-5': { inputPer1M: 1, outputPer1M: 5 },