actoviq-agent-sdk 0.4.6 → 0.4.7

package/dist/src/events/runEvents.js

@@ -0,0 +1,143 @@
+import { randomBytes, randomUUID } from 'node:crypto';
+/** Creates versioned, monotonically sequenced events for exactly one run. */
+export class RunEventSequencer {
+    context;
+    sequence;
+    constructor(context, lastCommittedSequence = 0) {
+        this.context = context;
+        if (!Number.isSafeInteger(lastCommittedSequence) || lastCommittedSequence < 0) {
+            throw new RangeError('lastCommittedSequence must be a non-negative safe integer.');
+        }
+        this.sequence = lastCommittedSequence;
+    }
+    next(type, data, timestamp = new Date().toISOString()) {
+        if (!type.trim())
+            throw new Error('Run event type must not be empty.');
+        this.sequence += 1;
+        return {
+            schemaVersion: 1,
+            eventId: randomUUID(),
+            sequence: this.sequence,
+            runId: this.context.runId,
+            parentRunId: this.context.parentRunId,
+            traceId: this.context.traceId,
+            spanId: this.context.spanId,
+            parentSpanId: this.context.parentSpanId,
+            type,
+            timestamp,
+            data,
+        };
+    }
+    get lastSequence() {
+        return this.sequence;
+    }
+}
+/** Awaited processor/sink pipeline: sink speed applies backpressure to the run. */
+export class EventDispatcher {
+    processors;
+    sinks;
+    failureMode;
+    onSinkError;
+    onProcessorError;
+    closed = false;
+    constructor(options = {}) {
+        this.processors = [...(options.processors ?? [])];
+        this.sinks = [...(options.sinks ?? [])];
+        this.failureMode = options.failureMode ?? 'throw';
+        this.onSinkError = options.onSinkError;
+        this.onProcessorError = options.onProcessorError;
+        assertUniqueIds(this.processors, 'processor');
+        assertUniqueIds(this.sinks, 'sink');
+    }
+    async dispatch(event) {
+        if (this.closed)
+            throw new Error('EventDispatcher is closed.');
+        let current = event;
+        for (const processor of this.processors) {
+            if (!current)
+                break;
+            const source = current;
+            try {
+                current = await processor.process(source);
+            }
+            catch (error) {
+                this.onProcessorError?.(processor, error, source);
+                if (this.failureMode === 'throw')
+                    throw error;
+            }
+        }
+        if (!current)
+            return null;
+        for (const sink of this.sinks) {
+            try {
+                await sink.write(current);
+            }
+            catch (error) {
+                this.onSinkError?.(sink, error, current);
+                if (this.failureMode === 'throw')
+                    throw error;
+            }
+        }
+        return current;
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        const results = await Promise.allSettled(this.sinks.map(sink => sink.close?.()));
+        const failures = results
+            .filter((result) => result.status === 'rejected')
+            .map(result => result.reason);
+        if (failures.length > 0) {
+            throw new AggregateError(failures, 'One or more event sinks failed to close.');
+        }
+    }
+}
+/** Test/local sink with event-id deduplication and per-run sequence validation. */
+export class InMemoryEventSink {
+    id = 'memory';
+    eventIds = new Set();
+    lastSequenceByRun = new Map();
+    events = [];
+    write(event) {
+        if (this.eventIds.has(event.eventId))
+            return;
+        const previous = this.lastSequenceByRun.get(event.runId) ?? 0;
+        if (event.sequence <= previous) {
+            throw new Error(`Run ${event.runId} event sequence ${event.sequence} is not greater than ${previous}.`);
+        }
+        this.eventIds.add(event.eventId);
+        this.lastSequenceByRun.set(event.runId, event.sequence);
+        this.events.push(structuredClone(event));
+    }
+}
+export function createRootTraceContext(runId) {
+    return {
+        runId,
+        traceId: randomHex(16),
+        spanId: randomHex(8),
+    };
+}
+export function createChildTraceContext(runId, parentRunId, parent) {
+    return {
+        runId,
+        parentRunId,
+        traceId: parent.traceId,
+        spanId: randomHex(8),
+        parentSpanId: parent.spanId,
+    };
+}
+function randomHex(bytes) {
+    return randomBytes(bytes).toString('hex');
+}
+function assertUniqueIds(items, kind) {
+    const seen = new Set();
+    for (const item of items) {
+        if (!item.id.trim())
+            throw new Error(`Event ${kind} id must not be empty.`);
+        if (seen.has(item.id))
+            throw new Error(`Duplicate event ${kind} id "${item.id}".`);
+        seen.add(item.id);
+    }
+}
+//# sourceMappingURL=runEvents.js.map

package/dist/src/events/runEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runEvents.js","sourceRoot":"","sources":["../../../src/events/runEvents.ts"],"names":[],"mappings":"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"}

package/dist/src/gui/actoviqGui.d.ts

@@ -17,6 +17,21 @@ export interface ActoviqGuiServer {
     token: string;
     close(): Promise<void>;
 }
+export type BrowseEntryKind = 'drive' | 'folder' | 'file';
+export type BrowseEntry = {
+    name: string;
+    path: string;
+    kind: BrowseEntryKind;
+};
+export type BrowseDirectoryResult = {
+    path: string;
+    parent: string | null;
+    entries: BrowseEntry[];
+};
+/** List folders for the in-app workspace browser (GET /api/browse). */
+export declare function browseDirectory(requestPath?: string): Promise<BrowseDirectoryResult>;
+/** List folders + files for the conversation Files panel. */
+export declare function listWorkspaceFiles(requestPath?: string, fallbackRoot?: string): Promise<BrowseDirectoryResult>;
 export declare function startActoviqGuiServer(options?: ActoviqGuiOptions): Promise<ActoviqGuiServer>;
 export declare function runActoviqGui(options?: ActoviqGuiOptions): Promise<void>;
 export declare function createActoviqGuiHtml(): string;

package/dist/src/gui/actoviqGui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actoviqGui.d.ts","sourceRoot":"","sources":["../../../src/gui/actoviqGui.ts"],"names":[],"mappings":";AAwEA,OAAO,KAAK,EAGV,qBAAqB,EAStB,MAAM,aAAa,CAAC;AAerB,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,oGAAoG;IACpG,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAykBD,wBAAsB,qBAAqB,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmoDtG;AA+BD,wBAAsB,aAAa,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBlF;AAsED,wBAAgB,oBAAoB,IAAI,MAAM,CA8c7C;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAwY/C;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAk5DrD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAoB7G"}
+{"version":3,"file":"actoviqGui.d.ts","sourceRoot":"","sources":["../../../src/gui/actoviqGui.ts"],"names":[],"mappings":";AAuRA,OAAO,KAAK,EAGV,qBAAqB,EAkBtB,MAAM,aAAa,CAAC;AAiBrB,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,oGAAoG;IACpG,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAu5BD,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC1D,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AAChF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB,CAAC;AA8BF,uEAAuE;AACvE,wBAAsB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA6C1F;AAED,6DAA6D;AAC7D,wBAAsB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAmCpH;AA6OD,wBAAsB,qBAAqB,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwgItG;AA+BD,wBAAsB,aAAa,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBlF;AAwMD,wBAAgB,oBAAoB,IAAI,MAAM,CA62B7C;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CA2rF/C;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAqsXrD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAoB7G"}