@teaflask/assistant 0.3.0 → 0.7.0

package/src/core/approval-request-narrowing.ts

@@ -1,111 +0,0 @@
-// The approval wire's narrowers: an approval_requested
-// marker's value and a turn snapshot's coworker approval item, both `any`
-// by contract. Malformed values return null and are ignored — the
-// contract's "clients MUST ignore events and fields they do not
-// recognize". A dependency-free leaf, the twin of
-// execution-request-narrowing.ts.
-
-import type { ApprovalRequestedPayload } from "../contract/events.js";
-import { withoutStepCaption } from "./step-caption.js";
-
-/** One coworker approval as the turn snapshot lists it, narrowed. */
-export interface CoworkerApprovalRequest {
-  ordinal: number;
-  label: string;
-  childSessionId: string;
-  /** The coworker's own waiting execution already exited (its answer
-   *  still counts — the entity restarts it); never the parent's state. */
-  parked: boolean;
-  card: ApprovalRequestedPayload;
-}
-
-/** The turn fields the coworker adoption reads — the serving and the
- *  dashboard turn shapes both satisfy it. A turn with no id has no door
- *  a coworker's decision could be posted to, so it lists nothing. */
-export interface CoworkerApprovalTurn {
-  id?: string;
-  run_id: string | null;
-  pending_coworker_approvals?: readonly unknown[] | null;
-}
-
-/**
- * Narrow one pending_coworker_approvals item (any by contract): the
- * asker's identity plus the card in the marker's own shape, so the
- * marker narrowing below serves both askers. Malformed → null.
- */
-export function coworkerApprovalRequestOf(
-  value: unknown,
-): CoworkerApprovalRequest | null {
-  if (typeof value !== "object" || value === null) {
-    return null;
-  }
-  const record = value as Record<string, unknown>;
-  if (
-    typeof record.ordinal !== "number" ||
-    typeof record.label !== "string" ||
-    typeof record.child_session_id !== "string"
-  ) {
-    return null;
-  }
-  const card = approvalRequestedPayloadOf(record.card);
-  if (card === null) {
-    return null;
-  }
-  return {
-    ordinal: record.ordinal,
-    label: record.label,
-    childSessionId: record.child_session_id,
-    parked: record.parked === true,
-    card,
-  };
-}
-
-/**
- * Narrow an approval_requested CUSTOM event's wire value (any by contract).
- * Malformed payloads return null and are ignored — the contract's "clients
- * MUST ignore events and fields they do not recognize".
- */
-export function approvalRequestedPayloadOf(
-  value: unknown,
-): ApprovalRequestedPayload | null {
-  if (typeof value !== "object" || value === null) {
-    return null;
-  }
-  const record = value as Record<string, unknown>;
-  if (typeof record.interrupt_id !== "string" || record.interrupt_id === "") {
-    return null;
-  }
-  if (typeof record.prompt !== "string") {
-    return null;
-  }
-  return {
-    interrupt_id: record.interrupt_id,
-    prompt: record.prompt,
-    tool_name: typeof record.tool_name === "string" ? record.tool_name : null,
-    // The model's caption is the row's label, never an argument.
-    tool_args: withoutStepCaption(recordOrEmpty(record.tool_args)),
-    // Fail safe against an older wire: no schema means the generic card.
-    tool_input_schema: recordOrNull(record.tool_input_schema),
-    tool_output_schema: recordOrNull(record.tool_output_schema),
-    tool_call_id:
-      typeof record.tool_call_id === "string" ? record.tool_call_id : null,
-    round: typeof record.round === "number" ? record.round : 0,
-    // Fail safe against an older wire: no flag means no trust affordance.
-    gated: record.gated === true,
-    trust_available: record.trust_available === true,
-  };
-}
-
-function recordOrEmpty(value: unknown): Record<string, unknown> {
-  if (typeof value === "object" && value !== null && !Array.isArray(value)) {
-    return value as Record<string, unknown>;
-  }
-  return {};
-}
-
-function recordOrNull(value: unknown): Record<string, unknown> | null {
-  if (typeof value === "object" && value !== null && !Array.isArray(value)) {
-    return value as Record<string, unknown>;
-  }
-  return null;
-}

package/src/core/approval-resolved.ts

@@ -1,53 +0,0 @@
-// The approval_resolved payload narrower, pure of React. THE PREMISE,
-// stated: the WIRE contract is unchanged — the server records and serves
-// approval_resolved markers carrying interrupt_id, approved, feedback,
-// and resolved_by. This module is the CLIENT-SIDE narrower, and a
-// narrower copies only the fields something renders or decides on.
-// The three consumers: the approval inbox (approvalInboxRecorder →
-// noteApprovalResolved) and the denial ledger (tool-denial-anchors.ts)
-// read exactly interruptId and approved; the dashboard's audit receipt
-// row, which imports this narrower through ./transcript, renders
-// feedback and resolvedBy too — so those ride as optional fields,
-// present only when the wire sent strings. Extra wire fields are
-// ignored by construction (the narrower
-// reads named keys off the payload); narrowing returns null only on a
-// missing/mistyped interrupt_id or approved, so a server sending a richer
-// payload can neither throw nor drop an event here. (The anchoring half
-// this module once carried — recorder, anchor maps, receipt sentences —
-// went with the deleted meta-receipt rows; the file lost the "-anchors"
-// name with it.)
-
-import type { ApprovalResolvedPayload } from "../contract/events.js";
-
-export interface ApprovalResolved {
-  interruptId: string;
-  approved: boolean;
-  feedback?: string;
-  /** A prefixed actor handle ("member:<uuid>" / "eu:<id>"); absent for anonymous visitors. */
-  resolvedBy?: string;
-}
-
-export function approvalResolvedPayloadOf(
-  value: unknown,
-): ApprovalResolved | null {
-  if (typeof value !== "object" || value === null) {
-    return null;
-  }
-  const payload = value as Partial<ApprovalResolvedPayload>;
-  if (
-    typeof payload.interrupt_id !== "string" ||
-    typeof payload.approved !== "boolean"
-  ) {
-    return null;
-  }
-  return {
-    interruptId: payload.interrupt_id,
-    approved: payload.approved,
-    // The optional fields may arrive as null or be absent entirely —
-    // the stored payload keeps whatever the marker model dumped.
-    feedback:
-      typeof payload.feedback === "string" ? payload.feedback : undefined,
-    resolvedBy:
-      typeof payload.resolved_by === "string" ? payload.resolved_by : undefined,
-  };
-}

package/src/core/assistant-prose.ts

@@ -1,32 +0,0 @@
-// The one "assistant prose" predicate.
-//
-// REQUIRED INVARIANT, not incidental sharing: memory attribution
-// (core/memory-provenance-anchors.ts) selects the message id a footer
-// anchors to with this predicate, and the projection
-// (core/transcript-rows.ts) emits the assistant-text row — the footer's
-// ONLY host — under the same predicate. If the two ever disagree (one
-// side trims whitespace, or starts handling array content), an
-// attributed id can fail to project and footers silently stop
-// rendering, with no test naming the cause. Any change to what counts
-// as prose must happen HERE, once, for both consumers.
-
-import type { Message } from "@ag-ui/core";
-
-/** The newest assistant message with visible prose — the only row kind
- *  a memory footer may render under (tool results, tool-call-only
- *  messages, and reasoning never host one). */
-export function newestAssistantProseIdOf(
-  messages: readonly Message[],
-): string | null {
-  for (let index = messages.length - 1; index >= 0; index -= 1) {
-    const message = messages[index];
-    if (
-      message.role === "assistant" &&
-      typeof message.content === "string" &&
-      message.content !== ""
-    ) {
-      return message.id;
-    }
-  }
-  return null;
-}