@taico/events 0.8.6 → 0.9.1

package/README.md

@@ -1,3 +1,3 @@
 # @taico/events
 
-[![Socket Badge](https://badge.socket.dev/npm/package/@taico/events/0.8.6)](https://badge.socket.dev/npm/package/@taico/events/0.8.6)
+[![Socket Badge](https://badge.socket.dev/npm/package/@taico/events/0.9.1)](https://badge.socket.dev/npm/package/@taico/events/0.9.1)

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './types/task-events.js';
 export * from './types/thread-events.js';
 export * from './types/execution-events.js';
+export * from './types/execution-traces.js';
 export * from './types/worker-events.js';

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from './types/task-events.js';
 export * from './types/thread-events.js';
 export * from './types/execution-events.js';
+export * from './types/execution-traces.js';
 export * from './types/worker-events.js';

package/dist/types/execution-events.d.ts

@@ -19,12 +19,14 @@ export declare const ExecutionWireEvents: {
     readonly EXECUTION_DELETED: "execution.deleted";
     readonly EXECUTION_ACTIVITY: "execution.activity";
     readonly EXECUTION_ACTIVITY_POST: "execution.activity.post";
+    readonly EXECUTION_TRACE_POST: "execution.trace.post";
     readonly EXECUTION_HEARTBEAT_POST: "execution.heartbeat.post";
     readonly WORKER_HEARTBEAT_POST: "worker.heartbeat.post";
     readonly WORKER_HARNESSES_REPORT_REQUESTED: "worker.harnesses.report.requested";
     readonly TASK_EXECUTION_QUEUED: "task.execution.queued";
     readonly EXECUTION_INTERRUPT_REQUEST: "execution.interrupt.request";
     readonly EXECUTIONS_CHANGED: "executions.changed";
+    readonly EXECUTION_TRACES_CHANGED: "execution.traces.changed";
 };
 export type ExecutionWireEventName = (typeof ExecutionWireEvents)[keyof typeof ExecutionWireEvents];
 /**

package/dist/types/execution-events.js

@@ -18,12 +18,14 @@ export const ExecutionWireEvents = {
     EXECUTION_DELETED: 'execution.deleted',
     EXECUTION_ACTIVITY: 'execution.activity',
     EXECUTION_ACTIVITY_POST: 'execution.activity.post',
+    EXECUTION_TRACE_POST: 'execution.trace.post',
     EXECUTION_HEARTBEAT_POST: 'execution.heartbeat.post',
     WORKER_HEARTBEAT_POST: 'worker.heartbeat.post',
     WORKER_HARNESSES_REPORT_REQUESTED: 'worker.harnesses.report.requested',
     TASK_EXECUTION_QUEUED: 'task.execution.queued',
     EXECUTION_INTERRUPT_REQUEST: 'execution.interrupt.request',
     EXECUTIONS_CHANGED: 'executions.changed',
+    EXECUTION_TRACES_CHANGED: 'execution.traces.changed',
 };
 /**
  * Type guards for event identification

package/dist/types/execution-traces.d.ts

@@ -0,0 +1,48 @@
+export interface ExecutionTracesChangedWireEvent {
+    executionId: string;
+}
+/** Raw JSON from a harness, without formatter filtering or normalization. */
+export type HarnessJson = null | boolean | number | string | HarnessJson[] | {
+    [key: string]: HarnessJson;
+};
+export interface ExecutionTraceEvent {
+    sequence: number;
+    emittedAt: string;
+    runnerSessionId: string | null;
+    payload: HarnessJson;
+}
+export type ExecutionTraceSource = "worker" | "harness";
+export interface PostExecutionTracePayload {
+    executionId: string;
+    /** Omitted by older workers: defaults to harness. */
+    source?: ExecutionTraceSource;
+    /** SDK identity for harness events; worker events have no harness. */
+    harness: string | null;
+    events: ExecutionTraceEvent[];
+}
+/** Permanent rejections are quarantined locally instead of retried forever. */
+export interface ExecutionTraceAck {
+    ok: boolean;
+    permanent?: boolean;
+    retryable?: "disconnected";
+    error?: string;
+}
+export declare const EXECUTION_TRACE_BATCH_BYTES: number;
+export declare const EXECUTION_TRACE_MAX_BYTES: number;
+export declare const EXECUTION_TRACE_BATCH_SIZE = 100;
+/** Worker lifecycle records share the execution sequence with harness events. */
+export type ExecutionStep = "workspace" | "setup" | "agent" | "finish";
+export type ExecutionStepStatus = "running" | "completed" | "failed" | "interrupted" | "cancelled";
+export type ExecutionRepositoryProgress = {
+    slug: string;
+    repository: string;
+    action: "clone" | "fetch";
+    status: "running" | "completed" | "failed";
+};
+export type ExecutionStepEvent = {
+    type: "taico.execution.step";
+    step: ExecutionStep;
+    status: ExecutionStepStatus;
+    message?: string;
+    repository?: ExecutionRepositoryProgress;
+};

package/dist/types/execution-traces.js

@@ -0,0 +1,5 @@
+// Keep batches below Socket.IO's transport limit. A single event can exceed the
+// batching target; the server accepts frames up to EXECUTION_TRACE_MAX_BYTES.
+export const EXECUTION_TRACE_BATCH_BYTES = 512 * 1024;
+export const EXECUTION_TRACE_MAX_BYTES = 16 * 1024 * 1024;
+export const EXECUTION_TRACE_BATCH_SIZE = 100;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taico/events",
-  "version": "0.8.6",
+  "version": "0.9.1",
   "type": "module",
   "private": false,
   "license": "PolyForm-Small-Business-1.0.0",