@inixiative/foundry-core 0.5.12 → 0.5.13

package/package.json

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

@@ -418,6 +418,8 @@ export {
   type FanResult,
   Thread,
   type ThreadAgentStatus,
+  type ThreadArtifact,
+  type ThreadArtifactKind,
   type ThreadCheckout,
   type ThreadConfig,
   type ThreadContext,

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. */