@joshski/dust 0.1.78 → 0.1.79

package/dist/agent-events.d.ts

@@ -40,4 +40,15 @@ export interface EventMessage {
  * is forwarded as a claude-event.
  */
 export declare function rawEventToAgentEvent(rawEvent: Record<string, unknown>): AgentSessionEvent;
+/**
+ * Create a heartbeat throttler that limits agent-session-activity events
+ * to at most once per interval (default: 5 seconds).
+ *
+ * The returned callback converts raw Claude events to AgentSessionEvents,
+ * throttling stream_event heartbeats while forwarding all other events.
+ */
+export declare function createHeartbeatThrottler(onAgentEvent: (event: AgentSessionEvent) => void, options?: {
+    intervalMs?: number;
+    now?: () => number;
+}): (rawEvent: Record<string, unknown>) => void;
 export declare function formatAgentEvent(event: AgentSessionEvent): string | null;

package/dist/artifacts/index.d.ts

@@ -18,7 +18,9 @@ export interface TaskGraph {
 }
 export { CAPTURE_IDEA_PREFIX, findAllWorkflowTasks, parseOpenQuestions };
 export type { IdeaInProgress };
+export type ArtifactType = 'ideas' | 'tasks' | 'principles' | 'facts';
 export interface ArtifactsRepository {
+    artifactPath(type: ArtifactType, slug: string): string;
     parseIdea(options: {
         slug: string;
     }): Promise<Idea>;
@@ -63,4 +65,4 @@ export interface ArtifactsRepository {
     buildTaskGraph(): Promise<TaskGraph>;
 }
 export declare function buildArtifactsRepository(fileSystem: FileSystem, dustPath: string): ArtifactsRepository;
-export declare function buildReadOnlyArtifactsRepository(fileSystem: ReadableFileSystem, dustPath: string): Pick<ArtifactsRepository, 'parseIdea' | 'listIdeas' | 'parsePrinciple' | 'listPrinciples' | 'parseFact' | 'listFacts' | 'parseTask' | 'listTasks' | 'findWorkflowTaskForIdea' | 'parseCaptureIdeaTask' | 'buildTaskGraph'>;
+export declare function buildReadOnlyArtifactsRepository(fileSystem: ReadableFileSystem, dustPath: string): Pick<ArtifactsRepository, 'artifactPath' | 'parseIdea' | 'listIdeas' | 'parsePrinciple' | 'listPrinciples' | 'parseFact' | 'listFacts' | 'parseTask' | 'listTasks' | 'findWorkflowTaskForIdea' | 'parseCaptureIdeaTask' | 'buildTaskGraph'>;

package/dist/artifacts.js

@@ -548,6 +548,9 @@ async function parseCaptureIdeaTask(fileSystem, dustPath, taskSlug) {
 // lib/artifacts/index.ts
 function buildArtifactsRepository(fileSystem, dustPath) {
   return {
+    artifactPath(type, slug) {
+      return `${dustPath}/${type}/${slug}.md`;
+    },
     async parseIdea(options) {
       return parseIdea(fileSystem, dustPath, options.slug);
     },
@@ -635,6 +638,9 @@ function buildArtifactsRepository(fileSystem, dustPath) {
 }
 function buildReadOnlyArtifactsRepository(fileSystem, dustPath) {
   return {
+    artifactPath(type, slug) {
+      return `${dustPath}/${type}/${slug}.md`;
+    },
     async parseIdea(options) {
       return parseIdea(fileSystem, dustPath, options.slug);
     },

package/dist/dust.js

@@ -306,7 +306,7 @@ async function loadSettings(cwd, fileSystem) {
 }
 
 // lib/version.ts
-var DUST_VERSION = "0.1.78";
+var DUST_VERSION = "0.1.79";
 
 // lib/session.ts
 var DUST_UNATTENDED = "DUST_UNATTENDED";
@@ -2484,6 +2484,23 @@ function rawEventToAgentEvent(rawEvent) {
   }
   return { type: "claude-event", rawEvent };
 }
+var DEFAULT_HEARTBEAT_INTERVAL_MS = 5000;
+function createHeartbeatThrottler(onAgentEvent, options) {
+  const intervalMs = options?.intervalMs ?? DEFAULT_HEARTBEAT_INTERVAL_MS;
+  const now = options?.now ?? Date.now;
+  let lastHeartbeatTime;
+  return (rawEvent) => {
+    const event = rawEventToAgentEvent(rawEvent);
+    if (event.type === "agent-session-activity") {
+      const currentTime = now();
+      if (lastHeartbeatTime !== undefined && currentTime - lastHeartbeatTime < intervalMs) {
+        return;
+      }
+      lastHeartbeatTime = currentTime;
+    }
+    onAgentEvent(event);
+  };
+}
 function agentDisplayName(agentType) {
   if (agentType === "codex")
     return "Codex";
@@ -2942,9 +2959,7 @@ async function loopClaude(dependencies, loopDependencies = createDefaultDependen
   let completedIterations = 0;
   const iterationOptions = { hooksInstalled };
   if (eventsUrl) {
-    iterationOptions.onRawEvent = (rawEvent) => {
-      onAgentEvent(rawEventToAgentEvent(rawEvent));
-    };
+    iterationOptions.onRawEvent = createHeartbeatThrottler(onAgentEvent);
   }
   while (completedIterations < maxIterations) {
     agentSessionId = crypto.randomUUID();
@@ -3105,9 +3120,7 @@ async function runRepositoryLoop(repoState, repoDeps, sendEvent, sessionId) {
         hooksInstalled,
         signal: abortController.signal,
         repositoryId: repoState.repository.id.toString(),
-        onRawEvent: (rawEvent) => {
-          onAgentEvent(rawEventToAgentEvent(rawEvent));
-        }
+        onRawEvent: createHeartbeatThrottler(onAgentEvent)
       });
     } catch (error) {
       const msg = error instanceof Error ? error.message : String(error);

package/dist/types.d.ts

@@ -6,7 +6,7 @@
  */
 export type { AgentSessionEvent, EventMessage } from './agent-events';
 export type { Idea, IdeaOpenQuestion, IdeaOption } from './artifacts/ideas';
-export type { TaskGraph, TaskGraphNode } from './artifacts/index';
+export type { ArtifactType, TaskGraph, TaskGraphNode } from './artifacts/index';
 export type { Task } from './artifacts/tasks';
 export type { CreateIdeaTransitionTaskResult, DecomposeIdeaOptions, IdeaInProgress, OpenQuestionResponse, ParsedCaptureIdeaTask, WorkflowTaskMatch, WorkflowTaskType, } from './artifacts/workflow-tasks';
 export type { Repository } from './bucket/repository';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joshski/dust",
-  "version": "0.1.78",
+  "version": "0.1.79",
   "description": "Flow state for AI coding agents",
   "type": "module",
   "bin": {