@xenosystem/agent-interface-ui 0.1.21 → 0.1.23

package/dist/components/agent/webJobProgressView.js

@@ -0,0 +1,104 @@
+const OPERATION_LABELS = {
+    scrape: 'Scrape',
+    'batch-scrape': 'Batch scrape',
+    map: 'Map',
+    crawl: 'Crawl',
+    render: 'Render',
+    extract: 'Extract',
+};
+const STATE_LABELS = {
+    queued: 'Queued',
+    running: 'Running',
+    completed: 'Completed',
+    partial: 'Partial',
+    failed: 'Failed',
+    cancelled: 'Cancelled',
+};
+const STATE_TONES = {
+    queued: 'queued',
+    running: 'running',
+    completed: 'succeeded',
+    partial: 'partial',
+    failed: 'failed',
+    cancelled: 'cancelled',
+};
+export function deriveWebJobProgressView(progress, toolCallStatus = 'running') {
+    const { counters } = progress;
+    const stale = !progress.terminal && toolCallStatus === 'done';
+    // `knownPages` is the producer's own sum and the contract validator has already
+    // refused any payload where it disagrees with its operands, so no division here
+    // can exceed 1 and none can divide by a number the counters do not support.
+    const settled = counters.completedPages + counters.failedPages + counters.excludedPages;
+    const percent = counters.knownPages > 0
+        ? Math.max(0, Math.min(100, Math.round((settled / counters.knownPages) * 100)))
+        : null;
+    const countersText = counters.knownPages > 0
+        ? `${settled}/${counters.knownPages} pages`
+        : 'no pages yet';
+    // Spoken as adjectives ("10 completed"), so no pluralisation is involved and a
+    // count of one cannot read as broken English in a screen reader.
+    const detail = [
+        `${counters.completedPages} completed`,
+        `${counters.activePages} active`,
+        `${counters.queuedPages} queued`,
+    ];
+    if (counters.failedPages > 0)
+        detail.push(`${counters.failedPages} failed`);
+    if (counters.excludedPages > 0)
+        detail.push(`${counters.excludedPages} excluded`);
+    const operationLabel = OPERATION_LABELS[progress.operation];
+    const observedLabel = STATE_LABELS[progress.state];
+    const stateLabel = stale ? `Last seen ${observedLabel.toLowerCase()}` : observedLabel;
+    const valueText = `${stateLabel}. ${countersText}. ${detail.join(', ')}.`;
+    return {
+        jobId: progress.jobId,
+        // A stale row is never tinted as live. `queued` is the quietest tone and is
+        // the right one for "we are not watching this any more".
+        tone: stale ? 'queued' : STATE_TONES[progress.state],
+        stateLabel,
+        operationLabel,
+        stale,
+        percent,
+        countersText,
+        valueText,
+        ariaLabel: `Web ${operationLabel.toLowerCase()} job progress`,
+        terminal: progress.terminal,
+        ...(progress.terminalReason ? { terminalReason: progress.terminalReason } : {}),
+    };
+}
+/**
+ * Decide whether a Stop control may be offered, and refuse to offer one that
+ * would not do what its label says.
+ *
+ * 🔴 Four conditions, and dropping any of them produces a lie rather than a bug.
+ * A settled job cannot be stopped. A closed tool call has no turn to interrupt.
+ * A turn that is not the one in flight is not the turn cancellation would reach —
+ * pressing Stop on an older card would cancel somebody else's work. And a
+ * composition that exposes no cancellation at all must show no control, because
+ * a button that silently does nothing is worse than an absent one.
+ *
+ * ⚠️ What this authorises is a TURN cancellation, which is the only cancellation
+ * this surface is allowed to reach: cancelling the durable job itself is a
+ * provider call, and the renderer may not make one. The label and title must say
+ * so — see `WEB_JOB_STOP_TITLE`.
+ */
+export function webJobStopAvailability(input) {
+    if (input.progress.terminal)
+        return { available: false, reason: 'job_terminal' };
+    if (input.toolCallStatus !== 'running')
+        return { available: false, reason: 'tool_call_finished' };
+    if (!input.requestId || input.requestId !== input.activeRequestId) {
+        return { available: false, reason: 'turn_not_active' };
+    }
+    if (!input.hostExposesCancellation)
+        return { available: false, reason: 'host_exposes_no_cancellation' };
+    return { available: true };
+}
+export const WEB_JOB_STOP_LABEL = 'Stop';
+/**
+ * The exact wording matters. This stops the agent turn; it does not reach into
+ * the web service and cancel the job, and claiming otherwise would be the
+ * fabricated-success failure this repo forbids.
+ */
+export const WEB_JOB_STOP_TITLE = 'Stop this agent turn. The web job may keep running on the server until it settles.';
+//# sourceMappingURL=webJobProgressView.js.map

package/dist/components/agent/webJobProgressView.js.map

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

package/dist/platformApiTypes.d.ts

@@ -1413,10 +1413,42 @@ export interface XenoAPI {
             code?: import('@xenosystem/agent-interface-contract').AgentCockpitErrorCode;
             error: string | null;
         }>;
+        xenoTuiAttach?: (params: {
+            conversationId: string;
+            workspaceMode: 'workspace' | 'chat-only';
+            workingDirectory?: string;
+            workspaceId?: string;
+            providerKind: 'sdk-native' | 'xeno-cloud' | 'acp-provider';
+            providerId?: string;
+            acpAgentConfigId?: string;
+            model?: string;
+            cols?: number;
+            rows?: number;
+        }) => Promise<import('@xenosystem/agent-interface-contract').AgentXenoTuiAttachResult & {
+            lanes?: import('@xenosystem/agent-interface-contract').ProviderLaneProjectionV1[];
+        }>;
+        providerLaneSelect?: (params: {
+            conversationId: string;
+            workspaceMode: 'workspace' | 'chat-only';
+            workingDirectory?: string;
+            workspaceId?: string;
+            providerKind: 'sdk-native' | 'xeno-cloud' | 'acp-provider';
+            providerId?: string;
+            acpAgentConfigId?: string;
+            model?: string;
+        }) => Promise<{
+            success: boolean;
+            error?: string;
+            hostBinding?: import('@xenosystem/agent-interface-contract').AgentSessionHostBindingV1;
+            activeLane?: import('@xenosystem/agent-interface-contract').ProviderLaneProjectionV1;
+            lanes?: import('@xenosystem/agent-interface-contract').ProviderLaneProjectionV1[];
+        }>;
         providerNativeAttach?: (params: {
             conversationId: string;
             laneId: string;
             expectedLaneRevision: number;
+            workspaceTrust?: 'standard' | 'trusted';
+            executionPolicy?: import('@xenosystem/agent-interface-contract').AgentNativeExecutionPolicy;
             cols?: number;
             rows?: number;
         }) => Promise<import('@xenosystem/agent-interface-contract').AgentProviderNativeAttachResult>;