@inixiative/foundry-core 0.5.12 → 0.5.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inixiative/foundry-core",
-  "version": "0.5.12",
+  "version": "0.5.14",
   "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/event-stream.ts

@@ -42,6 +42,8 @@ export type StreamEvent =
       message: string;
       severity: 'error' | 'warn';
       timestamp: number;
+      /** The thread the error is about, when it is one thread's (the viewer shows it on that thread). */
+      threadId?: string;
     }
   | ({ kind: 'activity'; timestamp: number } & SystemActivity);
 
@@ -142,9 +144,21 @@ export class EventStream {
     return events.slice(-limit);
   }
 
-  /** Push an error event — surfaced as a toast in the viewer UI. */
-  pushError(source: string, message: string, severity: 'error' | 'warn' = 'error'): void {
-    this.push({ kind: 'error', source, message, severity, timestamp: Date.now() });
+  /** Push an error event — surfaced as a toast in the viewer UI, on its thread when it names one. */
+  pushError(
+    source: string,
+    message: string,
+    severity: 'error' | 'warn' = 'error',
+    threadId?: string,
+  ): void {
+    this.push({
+      kind: 'error',
+      source,
+      message,
+      severity,
+      timestamp: Date.now(),
+      ...(threadId ? { threadId } : {}),
+    });
   }
 
   /** Push what the system is doing (shown above the composer, never as a toast). */

package/src/index.ts

@@ -418,6 +418,8 @@ export {
   type FanResult,
   Thread,
   type ThreadAgentStatus,
+  type ThreadArtifact,
+  type ThreadArtifactKind,
   type ThreadCheckout,
   type ThreadConfig,
   type ThreadContext,
@@ -431,6 +433,7 @@ export {
   type ThreadPlan,
   type ThreadPlanItem,
   type ThreadReference,
+  type ThreadScheduled,
   type ThreadSnooze,
   type ThreadSpawn,
   type ThreadStatus,

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;
@@ -194,6 +214,15 @@ export interface ThreadFork {
   readonly journalSeq: number;
 }
 
+/** The schedule run a thread was started for (provenance; a run is top-level). */
+export interface ThreadScheduled {
+  readonly scheduleId: string;
+  /** The run's id, `schedule:<scheduleId>:<dueAt>`: one run per due time. */
+  readonly runId: string;
+  /** When the run was due (epoch ms). */
+  readonly dueAt: number;
+}
+
 /** 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';
@@ -241,6 +270,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. */
@@ -270,6 +301,9 @@ export interface ThreadMeta {
   /** The thread and point this one was forked from (provenance; a fork is top-level). */
   forkedFrom?: ThreadFork;
 
+  /** The schedule run this thread was started for. */
+  scheduledBy?: ThreadScheduled;
+
   /** How this subagent thread was spawned. */
   spawn?: ThreadSpawn;
 
@@ -387,6 +421,8 @@ export interface ThreadConfig {
   parentThreadId?: string;
   /** The thread and point this one was forked from. */
   forkedFrom?: ThreadFork;
+  /** The schedule run this thread was started for. */
+  scheduledBy?: ThreadScheduled;
   /** Project that owns this thread. Scopes memory sources and tool calls. */
   projectId?: string;
   /** The harness running this thread's main session. */
@@ -444,6 +480,7 @@ export class Thread {
       branch: opts?.branch,
       parentThreadId: opts?.parentThreadId,
       ...(opts?.forkedFrom ? { forkedFrom: opts.forkedFrom } : {}),
+      ...(opts?.scheduledBy ? { scheduledBy: opts.scheduledBy } : {}),
       projectId: opts?.projectId,
       ...(opts?.worker ? { worker: opts.worker } : {}),
       ...(opts?.role ? { role: opts.role } : {}),