@modelprofile.com/flexharness 9.10.0 → 10.1.0

package/dist_ts/utils.storerules.js

@@ -0,0 +1,107 @@
+import { FlexHarnessStoreConflictError, FlexHarnessStoreFormatError, FlexHarnessValidationError, } from './errors.js';
+import { assertJsonSerializable, cloneSerializable } from './utils.json.js';
+import { assertExactKeys, assertRecord } from './utils.storecodecs.js';
+export function validateIdentifier(value, name) {
+    if (typeof value !== 'string' || !value.trim()) {
+        throw new FlexHarnessValidationError(`${name} must be a non-empty string.`);
+    }
+}
+export function validateExpectedRevision(expectedRevision) {
+    if (!Number.isSafeInteger(expectedRevision) || expectedRevision < 0) {
+        throw new FlexHarnessValidationError('expectedRevision must be a non-negative integer.');
+    }
+}
+export function validateProjectManagementWriteContext(writeContext) {
+    assertJsonSerializable(writeContext, '$writeContext');
+    assertRecord(writeContext, 'writeContext');
+    assertExactKeys(writeContext, ['actor', 'runId', 'agent', 'toolCallId'], 'writeContext');
+    if (writeContext.actor !== 'agent' && writeContext.actor !== 'application') {
+        throw new FlexHarnessValidationError('writeContext.actor must be agent or application.');
+    }
+    for (const key of ['runId', 'agent', 'toolCallId']) {
+        if (writeContext[key] !== undefined)
+            validateIdentifier(writeContext[key], `writeContext.${key}`);
+    }
+}
+export function validateSnapshotSave(snapshot, expectedRevision, validator) {
+    validator(snapshot);
+    validateExpectedRevision(expectedRevision);
+    if (snapshot.revision !== expectedRevision + 1) {
+        throw new FlexHarnessStoreFormatError(`Snapshot revision ${snapshot.revision} must equal expected revision ${expectedRevision} plus one.`);
+    }
+    return cloneSerializable(snapshot);
+}
+export function providerKey(storageKey, sessionId) {
+    validateIdentifier(storageKey, 'storageKey');
+    validateIdentifier(sessionId, 'sessionId');
+    return JSON.stringify([storageKey, sessionId]);
+}
+export function assertProjectionSession(snapshot, sessionId) {
+    for (const message of snapshot.messages) {
+        if (message.sessionId !== sessionId) {
+            throw new FlexHarnessStoreFormatError(`Projection message "${message.messageId}" does not belong to session "${sessionId}".`);
+        }
+    }
+    for (const terminal of snapshot.stagedTerminals) {
+        if (terminal.userMessage.sessionId !== sessionId
+            || terminal.assistantMessage.sessionId !== sessionId) {
+            throw new FlexHarnessStoreFormatError(`Staged terminal "${terminal.runId}" does not belong to session "${sessionId}".`);
+        }
+    }
+}
+function sameProjectManagementGeneration(left, right) {
+    return left.sessionGenerationId === right.sessionGenerationId
+        && left.sessionGenerationSequence === right.sessionGenerationSequence;
+}
+function canInitializeProjectManagementGeneration(current, next, expectedRevision) {
+    return 'deletedAt' in current
+        && expectedRevision === 0
+        && next.sessionGenerationId !== current.sessionGenerationId
+        && next.sessionGenerationSequence > current.sessionGenerationSequence;
+}
+/**
+ * Admits a live project-management save over the stored record: a CAS save within the stored
+ * generation, or a newer generation that replaces a tombstone at expected revision 0.
+ */
+export function assertProjectManagementSaveAdmitted(key, current, snapshot, expectedRevision) {
+    const actualRevision = current?.revision ?? 0;
+    if (current && !sameProjectManagementGeneration(current, snapshot)) {
+        if (!canInitializeProjectManagementGeneration(current, snapshot, expectedRevision)) {
+            throw new FlexHarnessStoreConflictError(key, expectedRevision, actualRevision);
+        }
+    }
+    else if ((current && 'deletedAt' in current) || actualRevision !== expectedRevision) {
+        throw new FlexHarnessStoreConflictError(key, expectedRevision, actualRevision);
+    }
+}
+/**
+ * Admits a project-management tombstone over the stored record. Returns false when the same
+ * generation is already tombstoned, which makes a repeated cleanup idempotent.
+ */
+export function isProjectManagementTombstoneAdmitted(key, current, tombstone, expectedRevision) {
+    const actualRevision = current?.revision ?? 0;
+    if (current && sameProjectManagementGeneration(current, tombstone)) {
+        if ('deletedAt' in current)
+            return false;
+        if (actualRevision !== expectedRevision) {
+            throw new FlexHarnessStoreConflictError(key, expectedRevision, actualRevision);
+        }
+    }
+    else if (current) {
+        if (!canInitializeProjectManagementGeneration(current, tombstone, expectedRevision)) {
+            throw new FlexHarnessStoreConflictError(key, expectedRevision, actualRevision);
+        }
+    }
+    else if (actualRevision !== expectedRevision) {
+        throw new FlexHarnessStoreConflictError(key, expectedRevision, actualRevision);
+    }
+    return true;
+}
+/** An archive is written once; repeating it with the same events is a no-op. */
+export function assertSameArchiveEvents(existing, next) {
+    if (JSON.stringify(existing.events.map((event) => event.id))
+        !== JSON.stringify(next.events.map((event) => event.id))) {
+        throw new Error(`Archive "${next.archiveId}" already exists with different events.`);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuc3RvcmVydWxlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3V0aWxzLnN0b3JlcnVsZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUNMLDZCQUE2QixFQUM3QiwyQkFBMkIsRUFDM0IsMEJBQTBCLEdBQzNCLE1BQU0sYUFBYSxDQUFDO0FBVXJCLE9BQU8sRUFBRSxzQkFBc0IsRUFBRSxpQkFBaUIsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBQzVFLE9BQU8sRUFBRSxlQUFlLEVBQUUsWUFBWSxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFpQnZFLE1BQU0sVUFBVSxrQkFBa0IsQ0FBQyxLQUFhLEVBQUUsSUFBWTtJQUM1RCxJQUFJLE9BQU8sS0FBSyxLQUFLLFFBQVEsSUFBSSxDQUFDLEtBQUssQ0FBQyxJQUFJLEVBQUUsRUFBRSxDQUFDO1FBQy9DLE1BQU0sSUFBSSwwQkFBMEIsQ0FBQyxHQUFHLElBQUksOEJBQThCLENBQUMsQ0FBQztJQUM5RSxDQUFDO0FBQ0gsQ0FBQztBQUVELE1BQU0sVUFBVSx3QkFBd0IsQ0FBQyxnQkFBd0I7SUFDL0QsSUFBSSxDQUFDLE1BQU0sQ0FBQyxhQUFhLENBQUMsZ0JBQWdCLENBQUMsSUFBSSxnQkFBZ0IsR0FBRyxDQUFDLEVBQUUsQ0FBQztRQUNwRSxNQUFNLElBQUksMEJBQTBCLENBQUMsa0RBQWtELENBQUMsQ0FBQztJQUMzRixDQUFDO0FBQ0gsQ0FBQztBQUVELE1BQU0sVUFBVSxxQ0FBcUMsQ0FDbkQsWUFBZ0Q7SUFFaEQsc0JBQXNCLENBQUMsWUFBWSxFQUFFLGVBQWUsQ0FBQyxDQUFDO0lBQ3RELFlBQVksQ0FBQyxZQUFZLEVBQUUsY0FBYyxDQUFDLENBQUM7SUFDM0MsZUFBZSxDQUFDLFlBQVksRUFBRSxDQUFDLE9BQU8sRUFBRSxPQUFPLEVBQUUsT0FBTyxFQUFFLFlBQVksQ0FBQyxFQUFFLGNBQWMsQ0FBQyxDQUFDO0lBQ3pGLElBQUksWUFBWSxDQUFD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

package/dist_ts_chat_harness/classes.transcript.d.ts

@@ -0,0 +1,88 @@
+import type * as plugins from './plugins.js';
+import type { IFlexMessage, IFlexPermissionRequest, IFlexProjectStateResult, IFlexSession, TFlexHarnessEvent } from '../dist_ts/interfaces.js';
+export interface IFlexHarnessTranscriptOptions {
+    scopeId: string;
+    sessionId: string;
+}
+/** What `load()` reads: the session's authoritative state, as the harness APIs return it. */
+export interface IFlexHarnessTranscriptSnapshot {
+    /** `getMessages()` of the session. */
+    messages: readonly IFlexMessage[];
+    /** `listPendingPermissions()` of the session. */
+    permissions?: readonly IFlexPermissionRequest[];
+    /** `getSession()`; states whether a run is active or failed. */
+    session?: IFlexSession;
+    /** `getProjectState()`, when project management is enabled. */
+    project?: IFlexProjectStateResult;
+}
+/** The inputs of `dees-harness-chat`, as plain data the transcript does not share. */
+export interface IFlexHarnessTranscriptView {
+    messages: plugins.IHarnessMessage[];
+    permissions: plugins.IHarnessPermissionRequest[];
+    /** FlexHarness asks no questions; always empty. */
+    questions: plugins.IHarnessQuestionRequest[];
+    status: plugins.IHarnessStatus;
+    usage: plugins.IHarnessUsage;
+    todos: plugins.IHarnessTodoItem[];
+    scratchpad?: plugins.IHarnessScratchpad;
+}
+/** Where an event stands in its harness instance's event stream, as the host received it. */
+export interface IFlexHarnessEventDelivery {
+    /**
+     * The `sequence` of the event of the same harness instance the host received just before this
+     * one, of any session; `undefined` for the first event after `load()`. The host forwards every
+     * event of the instance in order, and calls `load()` after a gap or a reconnect.
+     */
+    precedingSequence: number | undefined;
+}
+/**
+ * What one event changed. Apply `deltas` with `applyDelta()` in order; when `messages` is true,
+ * assign `transcript.view().messages` instead, which already holds the deltas. `reload` means
+ * the transcript can no longer follow the session incrementally: read the session again and
+ * pass it to `load()`.
+ */
+export interface IFlexHarnessTranscriptChange {
+    messages: boolean;
+    deltas: plugins.THarnessStreamDelta[];
+    permissions: boolean;
+    status: boolean;
+    usage: boolean;
+    reload: boolean;
+}
+/**
+ * Follows one FlexHarness session and keeps the `dees-harness-chat` inputs for it. It is a pure
+ * reducer over the session's public messages and events: it imports no runtime code, so it runs
+ * in the browser beside the components as well as on the server beside the harness.
+ */
+export declare class FlexHarnessTranscript {
+    readonly scopeId: string;
+    readonly sessionId: string;
+    private flexMessages;
+    private readonly timings;
+    private readonly partBytes;
+    private readonly permissionRows;
+    private status;
+    private usage;
+    private todos;
+    private scratchpad?;
+    private runningQueueId?;
+    constructor(options: IFlexHarnessTranscriptOptions);
+    /** The queue entry whose run is running; a steer joins it. */
+    get activeQueueId(): string | undefined;
+    /** Replaces everything with the session's authoritative state. */
+    load(snapshot: IFlexHarnessTranscriptSnapshot): void;
+    /** Takes in the session's task list and scratchpad after `getProjectState()`. */
+    applyProjectState(project: IFlexProjectStateResult): void;
+    /** A copy of the component inputs; the transcript keeps its own objects. */
+    view(): IFlexHarnessTranscriptView;
+    /**
+     * Takes one event of the harness instance. An event that does not directly follow
+     * `delivery.precedingSequence` means events were lost, possibly of this session, so the change
+     * asks for a reload.
+     */
+    applyEvent(event: TFlexHarnessEvent, delivery: IFlexHarnessEventDelivery): IFlexHarnessTranscriptChange;
+    private setStatus;
+    private upsertMessage;
+    private applyPartSnapshot;
+    private applyPartDelta;
+}

package/dist_ts_chat_harness/classes.transcript.js

@@ -0,0 +1,268 @@
+import { flexMessageToHarnessRows, flexPartRowId, flexPartTimingKey, flexPermissionToHarness, flexProjectToHarnessScratchpad, flexProjectToHarnessTodos, flexSessionToHarnessStatus, flexToolPartToHarness, flexUsageToHarness, } from './functions.mapping.js';
+const utf8 = new TextEncoder();
+/** UTF-8 bytes `delta` adds to `text`, counted the way FlexHarness counts them. */
+function appendedUtf8Bytes(text, delta) {
+    const trailing = text.charCodeAt(text.length - 1);
+    const leading = delta.charCodeAt(0);
+    const joinsSurrogatePair = trailing >= 0xd800 && trailing <= 0xdbff
+        && leading >= 0xdc00 && leading <= 0xdfff;
+    return utf8.encode(delta).length - (joinsSurrogatePair ? 2 : 0);
+}
+function sumUsage(total, usage) {
+    const sum = (key) => (total[key] ?? 0) + (usage[key] ?? 0);
+    return {
+        inputTokens: sum('inputTokens'),
+        outputTokens: sum('outputTokens'),
+        totalTokens: sum('totalTokens'),
+        cacheReadTokens: sum('cacheReadTokens'),
+        cacheWriteTokens: sum('cacheWriteTokens'),
+    };
+}
+const noChange = () => ({
+    messages: false,
+    deltas: [],
+    permissions: false,
+    status: false,
+    usage: false,
+    reload: false,
+});
+/**
+ * Follows one FlexHarness session and keeps the `dees-harness-chat` inputs for it. It is a pure
+ * reducer over the session's public messages and events: it imports no runtime code, so it runs
+ * in the browser beside the components as well as on the server beside the harness.
+ */
+export class FlexHarnessTranscript {
+    scopeId;
+    sessionId;
+    flexMessages = [];
+    timings = new Map();
+    partBytes = new Map();
+    permissionRows = new Map();
+    status = { type: 'idle' };
+    usage = {};
+    todos = [];
+    scratchpad;
+    runningQueueId;
+    constructor(options) {
+        this.scopeId = options.scopeId;
+        this.sessionId = options.sessionId;
+    }
+    /** The queue entry whose run is running; a steer joins it. */
+    get activeQueueId() {
+        return this.runningQueueId;
+    }
+    /** Replaces everything with the session's authoritative state. */
+    load(snapshot) {
+        this.flexMessages = [];
+        this.todos = [];
+        this.scratchpad = undefined;
+        this.runningQueueId = undefined;
+        this.timings.clear();
+        this.partBytes.clear();
+        for (const message of snapshot.messages)
+            this.upsertMessage(message);
+        this.permissionRows.clear();
+        for (const request of snapshot.permissions ?? []) {
+            this.permissionRows.set(request.permissionId, flexPermissionToHarness(request));
+        }
+        this.status = snapshot.session ? flexSessionToHarnessStatus(snapshot.session) : { type: 'idle' };
+        this.usage = this.flexMessages.reduce((total, message) => message.usage ? sumUsage(total, flexUsageToHarness(message.usage)) : total, {});
+        if (snapshot.project)
+            this.applyProjectState(snapshot.project);
+    }
+    /** Takes in the session's task list and scratchpad after `getProjectState()`. */
+    applyProjectState(project) {
+        this.todos = flexProjectToHarnessTodos(project);
+        this.scratchpad = flexProjectToHarnessScratchpad(this.sessionId, project);
+    }
+    /** A copy of the component inputs; the transcript keeps its own objects. */
+    view() {
+        return structuredClone({
+            messages: this.flexMessages.flatMap((message, index) => flexMessageToHarnessRows(message, index, this.timings)),
+            permissions: [...this.permissionRows.values()],
+            questions: [],
+            status: this.status,
+            usage: this.usage,
+            todos: this.todos,
+            ...(this.scratchpad === undefined ? {} : { scratchpad: this.scratchpad }),
+        });
+    }
+    /**
+     * Takes one event of the harness instance. An event that does not directly follow
+     * `delivery.precedingSequence` means events were lost, possibly of this session, so the change
+     * asks for a reload.
+     */
+    applyEvent(event, delivery) {
+        const change = noChange();
+        if (delivery.precedingSequence !== undefined
+            && event.sequence !== delivery.precedingSequence + 1) {
+            change.reload = true;
+            return change;
+        }
+        if (event.scopeId !== this.scopeId || event.sessionId !== this.sessionId)
+            return change;
+        const timestamp = Date.parse(event.timestamp);
+        switch (event.type) {
+            case 'session.created':
+            case 'session.updated':
+                this.setStatus(change, flexSessionToHarnessStatus(event.session));
+                break;
+            case 'session.deleted':
+                this.load({ messages: [] });
+                change.messages = change.permissions = change.status = change.usage = true;
+                break;
+            case 'run.started':
+                this.setStatus(change, { type: 'busy' });
+                break;
+            case 'message.created':
+            case 'message.updated':
+                this.upsertMessage(event.message);
+                change.messages = true;
+                break;
+            case 'part.started':
+                this.timings.set(flexPartTimingKey(event.messageId, event.partId), { startedAt: timestamp });
+                this.applyPartSnapshot(change, event.messageId, event.partIndex, event.part);
+                break;
+            case 'part.updated':
+                this.applyPartSnapshot(change, event.messageId, event.partIndex, event.part);
+                break;
+            case 'part.completed': {
+                const key = flexPartTimingKey(event.messageId, event.partId);
+                this.timings.set(key, { ...this.timings.get(key), endedAt: timestamp });
+                this.applyPartSnapshot(change, event.messageId, event.partIndex, event.part);
+                break;
+            }
+            case 'part.delta':
+                this.applyPartDelta(change, event);
+                break;
+            case 'permission.requested':
+                this.permissionRows.set(event.request.permissionId, flexPermissionToHarness(event.request));
+                change.permissions = true;
+                break;
+            case 'permission.resolved': {
+                const row = this.permissionRows.get(event.request.permissionId);
+                if (!row)
+                    break;
+                row.response = event.decision;
+                row.respondedAt = timestamp;
+                change.permissions = true;
+                break;
+            }
+            case 'run.finished':
+                this.upsertMessage(event.message);
+                change.messages = true;
+                if (event.message.usage) {
+                    this.usage = sumUsage(this.usage, flexUsageToHarness(event.message.usage));
+                    change.usage = true;
+                }
+                this.setStatus(change, event.status === 'failed'
+                    ? { type: 'error', ...(event.error ? { message: event.error.message } : {}) }
+                    : { type: 'idle' });
+                break;
+            case 'prompt.started':
+            case 'prompt.running':
+                this.runningQueueId = event.queueId;
+                break;
+            case 'prompt.finished':
+                if (this.runningQueueId === event.queueId)
+                    this.runningQueueId = undefined;
+                break;
+            case 'session.history.changed':
+                change.reload = true;
+                break;
+            default:
+                break;
+        }
+        return change;
+    }
+    setStatus(change, status) {
+        if (status.type === this.status.type && status.message === this.status.message)
+            return;
+        this.status = status;
+        change.status = true;
+    }
+    upsertMessage(message) {
+        const index = this.flexMessages.findIndex((entry) => entry.messageId === message.messageId);
+        const copy = structuredClone(message);
+        if (index === -1)
+            this.flexMessages.push(copy);
+        else
+            this.flexMessages[index] = copy;
+        for (const part of copy.parts) {
+            if (part.type === 'text' || part.type === 'reasoning') {
+                this.partBytes.set(flexPartTimingKey(copy.messageId, part.partId), utf8.encode(part.text).length);
+            }
+        }
+    }
+    applyPartSnapshot(change, messageId, partIndex, part) {
+        const message = this.flexMessages.find((entry) => entry.messageId === messageId);
+        if (!message || partIndex > message.parts.length) {
+            change.reload = true;
+            return;
+        }
+        const previous = message.parts[partIndex];
+        message.parts[partIndex] = structuredClone(part);
+        const key = flexPartTimingKey(messageId, part.partId);
+        if (part.type === 'text' || part.type === 'reasoning') {
+            this.partBytes.set(key, utf8.encode(part.text).length);
+        }
+        const rowId = flexPartRowId(messageId, part.partId);
+        if (previous?.partId !== part.partId || previous.type !== part.type) {
+            change.messages = true;
+            return;
+        }
+        if (part.type === 'tool') {
+            change.deltas.push({
+                type: 'tool-update',
+                messageId: rowId,
+                tool: flexToolPartToHarness(part, this.timings.get(key)),
+            });
+        }
+        else if (part.type === 'text' && previous.type === 'text') {
+            if (previous.text !== part.text)
+                change.messages = true;
+            else if (message.status !== 'streaming' || partIndex !== message.parts.length - 1) {
+                change.deltas.push({ type: 'message-end', messageId: rowId });
+            }
+        }
+        else if (part.type === 'reasoning' && previous.type === 'reasoning') {
+            if (previous.text !== part.text)
+                change.messages = true;
+            else if (part.status !== 'running') {
+                change.deltas.push({
+                    type: 'reasoning-end',
+                    messageId: rowId,
+                    partId: part.partId,
+                    endedAt: this.timings.get(key)?.endedAt,
+                });
+            }
+        }
+        else {
+            change.messages = true;
+        }
+    }
+    applyPartDelta(change, event) {
+        const message = this.flexMessages.find((entry) => entry.messageId === event.messageId);
+        const part = message?.parts[event.partIndex];
+        const key = flexPartTimingKey(event.messageId, event.partId);
+        if (!part
+            || part.partId !== event.partId
+            || part.type !== event.partType
+            || this.partBytes.get(key) !== event.baseTextUtf8Bytes) {
+            change.reload = true;
+            return;
+        }
+        const bytes = event.baseTextUtf8Bytes + appendedUtf8Bytes(part.text, event.delta);
+        if (bytes !== event.textUtf8Bytes) {
+            change.reload = true;
+            return;
+        }
+        part.text += event.delta;
+        this.partBytes.set(key, bytes);
+        const rowId = flexPartRowId(event.messageId, event.partId);
+        change.deltas.push(event.partType === 'text'
+            ? { type: 'text', messageId: rowId, delta: event.delta }
+            : { type: 'reasoning', messageId: rowId, partId: event.partId, delta: event.delta });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy50cmFuc2NyaXB0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHNfY2hhdF9oYXJuZXNzL2NsYXNzZXMudHJhbnNjcmlwdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFTQSxPQUFPLEVBQ0wsd0JBQXdCLEVBQ3hCLGFBQWEsRUFDYixpQkFBaUIsRUFDakIsdUJBQXVCLEVBQ3ZCLDhCQUE4QixFQUM5Qix5QkFBeUIsRUFDekIsMEJBQTBCLEVBQzFCLHFCQUFxQixFQUNyQixrQkFBa0IsR0FFbkIsTUFBTSx3QkFBd0IsQ0FBQztBQXdEaEMsTUFBTSxJQUFJLEdBQUcsSUFBSSxXQUFXLEVBQUUsQ0FBQztBQUUvQixtRkFBbUY7QUFDbkYsU0FBUyxpQkFBaUIsQ0FBQyxJQUFZLEVBQUUsS0FBYTtJQUNwRCxNQUFNLFFBQVEsR0FBRyxJQUFJLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxNQUFNLEdBQUcsQ0FBQyxDQUFDLENBQUM7SUFDbEQsTUFBTSxPQUFPLEdBQUcsS0FBSyxDQUFDLFVBQVUsQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUNwQyxNQUFNLGtCQUFrQixHQUFHLFFBQVEsSUFBSSxNQUFNLElBQUksUUFBUSxJQUFJLE1BQU07V0FDOUQsT0FBTyxJQUFJLE1BQU0sSUFBSSxPQUFPLElBQUksTUFBTSxDQUFDO0lBQzVDLE9BQU8sSUFBSSxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQyxNQUFNLEdBQUcsQ0FBQyxrQkFBa0IsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztBQUNsRSxDQUFDO0FBRUQsU0FBUyxRQUFRLENBQ2YsS0FBNEIsRUFDNUIsS0FBNEI7SUFFNUIsTUFBTSxHQUFHLEdBQUcsQ0FBQyxHQUFnQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDLENBQUMsR0FBRyxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMs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

package/dist_ts_chat_harness/functions.intents.d.ts

@@ -0,0 +1,62 @@
+import type * as plugins from './plugins.js';
+import type { FlexHarness } from '../dist_ts/classes.flexharness.js';
+import type { IFlexPromptOptions, IFlexPromptQueueAdmission, TFlexPermissionDecision, TFlexPromptPart } from '../dist_ts/interfaces.js';
+/** The session a chat view shows. */
+export interface IFlexHarnessChatTarget {
+    scopeId: string;
+    sessionId: string;
+}
+/**
+ * One call a chat view asks the harness to make, as plain data a host can carry from the browser
+ * to the server that owns the harness.
+ */
+export type TFlexHarnessChatIntent = (IFlexHarnessChatTarget & {
+    type: 'enqueuePrompt';
+    prompt: TFlexPromptPart[];
+    options: IFlexPromptOptions;
+}) | (IFlexHarnessChatTarget & {
+    type: 'steerPrompt';
+    queueId: string;
+    steerId: string;
+    prompt: TFlexPromptPart[];
+    options: IFlexPromptOptions;
+}) | (IFlexHarnessChatTarget & {
+    type: 'respondToPermission';
+    permissionId: string;
+    decision: TFlexPermissionDecision;
+}) | (IFlexHarnessChatTarget & {
+    type: 'abort';
+});
+export interface IFlexHarnessSendIntentOptions {
+    /** The running queue entry, `FlexHarnessTranscript.activeQueueId`; a steer joins it. */
+    activeQueueId?: string;
+    /**
+     * The model hint the prompt carries. Defaults to the composer's `model`. A host that offers
+     * accounts or reasoning efforts encodes them in its own hint scheme here.
+     */
+    modelHint?: string;
+}
+/**
+ * Maps `harness-send`. A message sent while idle, or queued behind the running turn, becomes a
+ * queued prompt. A steer joins the running turn; with no running turn it is the next turn's
+ * input, so it is queued as well. A steer keeps the prompt options for that case only: it answers
+ * on the running turn's model. A steer id comes from `crypto.randomUUID()`, which browsers offer
+ * in secure contexts only (HTTPS or localhost).
+ */
+export declare function flexHarnessSendIntent(target: IFlexHarnessChatTarget, detail: plugins.IHarnessComposerSendDetail, options?: IFlexHarnessSendIntentOptions): TFlexHarnessChatIntent;
+/**
+ * Maps `harness-permission-response`. The card reports a remembered approval as `remember`,
+ * which FlexHarness calls `always`.
+ */
+export declare function flexHarnessPermissionIntent(target: IFlexHarnessChatTarget, detail: plugins.IHarnessPermissionResponseDetail): TFlexHarnessChatIntent;
+/** Maps `harness-abort`. */
+export declare function flexHarnessAbortIntent(target: IFlexHarnessChatTarget): TFlexHarnessChatIntent;
+/** The harness calls `runFlexHarnessChatIntent` makes. */
+export type TFlexHarnessChatHost = Pick<FlexHarness<unknown>, 'enqueuePrompt' | 'steerPrompt' | 'respondToPermission' | 'abort'>;
+/**
+ * Makes the call an intent names, on the server that owns the harness, once the harness admitted
+ * it. A queued prompt returns its admission: its `completion` settles when the run ends, and the
+ * caller owns it, as with `enqueuePrompt()`. A steer whose turn ended before the harness took it
+ * is the next turn's input, so it is queued instead and returns that admission.
+ */
+export declare function runFlexHarnessChatIntent(harness: TFlexHarnessChatHost, intent: TFlexHarnessChatIntent): Promise<IFlexPromptQueueAdmission | undefined>;