@ziggs-ai/agent-sdk 0.1.4 → 0.1.6

package/src/types.ts

@@ -10,10 +10,10 @@
 export interface AgreementRef {
   agreementId: string;
   parties?: {
-    creatorId?: string;
-    providerId?: string;
-    payerId?: string;
-    proposedToId?: string;
+    creator?: string;
+    provider?: string;
+    payer?: string;
+    proposedTo?: string;
   };
   proposal?: { status?: 'pending' | 'approved' | 'rejected' | 'cancelled' };
   money?: { price?: number; paymentStatus?: string };
@@ -61,7 +61,7 @@ export type Outcome =
   | { kind: 'wait' }
   | { kind: 'timeout' }
   | { kind: 'message-sent'; text?: string; receiverId?: string }
-  | { kind: 'message-received'; text?: string; senderId?: string }
+  | { kind: 'message-received'; text?: string; senderId?: string; senderType?: string }
   | { kind: 'task-assigned'; task: TaskRef }
   | { kind: 'task-delegated'; task: TaskRef }
   | { kind: 'task-closed'; status: 'completed' | 'failed'; result?: unknown }
@@ -166,6 +166,13 @@ export interface Action {
   prompt: ActionPrompt;
   tool?: string | null;
   produces: Produces;
+  /**
+   * When true, the tool loop exits immediately after this action's tool result,
+   * even if the result is non-terminal. Prevents the LLM from issuing additional
+   * tool calls in the same turn (e.g. calling agreement_subcontract right after
+   * agent_search before the FSM can route to evaluatingCandidates).
+   */
+  terminatesLoop?: boolean;
 }
 
 export interface Transition {
@@ -283,6 +290,7 @@ import type { MemoryStore } from './memory/MemoryStore.js';
 export type EffectKind =
   | 'read-context'
   | 'llm-call'
+  | 'stream-text'
   | 'tool-call'
   | 'send-message'
   | 'record-event'
@@ -295,9 +303,39 @@ export interface ScopeRef { kind: 'chat' | 'agreement' | 'task' | 'counterparty'
 
 export type Effect =
   | { kind: 'read-context'; sessionId: string; opts?: ReadContextOpts }
-  | { kind: 'llm-call'; messages: LlmMessage[]; tools: LlmToolSchema[] }
-  | { kind: 'tool-call'; sessionId: string; name: string; args: unknown; memory?: MemoryStore }
-  | { kind: 'send-message'; sessionId: string; receiverId: string; text: string }
+  | {
+      kind: 'llm-call';
+      messages: LlmMessage[];
+      tools: LlmToolSchema[];
+      /** Chat/session id for monitoring ingest (ZIG-360). */
+      sessionId?: string;
+      /** Per-turn UUID grouping all LLM + tool calls in one turn (ZIG-440). */
+      runId?: string;
+      /** FSM state name at the time of this call (ZIG-440). */
+      stateId?: string;
+    }
+  | {
+      kind: 'stream-text';
+      sessionId: string;
+      receiverId: string;
+      /** Pre-allocated messageId shared across all chunks and the final send-message. */
+      messageId: string;
+      messages: LlmMessage[];
+    }
+  | {
+      kind: 'tool-call';
+      sessionId: string;
+      name: string;
+      args: unknown;
+      memory?: MemoryStore;
+      senderId?: string;
+      senderType?: string;
+      /** Per-turn UUID (ZIG-440). */
+      runId?: string;
+      /** FSM state name (ZIG-440). */
+      stateId?: string;
+    }
+  | { kind: 'send-message'; sessionId: string; receiverId: string; text: string; messageId?: string }
   | { kind: 'record-event'; sessionId: string; entry: RecordedEntry }
   | { kind: 'get-scope'; via: ScopeRef }
   | { kind: 'list-messages'; chatId: string; after?: string; limit?: number }
@@ -312,6 +350,7 @@ export type Effect =
 export interface EffectResultMap {
   'read-context': ContextSnapshot;
   'llm-call': LlmResponse;
+  'stream-text': { text: string };
   'tool-call': ToolCallResult;
   'send-message': { ok: true };
   'record-event': { ok: true };

package/src/tasks/taskCore.ts

@@ -1,139 +0,0 @@
-/**
- * Canonical Task definitions — states, state machine, shapes, and helpers.
- * ⚠️  SYNC: Keep in sync with backend/src/tasks/task-core.ts
- *           and backend/src/agreements/agreement.schema.ts
- */
-
-export const TaskState = {
-  PROPOSAL:  'proposal',
-  ACTIVE:    'active',
-  COMPLETED: 'completed',
-  FAILED:    'failed',
-  CANCELLED: 'cancelled',
-} as const;
-
-export type TaskStateValue = (typeof TaskState)[keyof typeof TaskState];
-
-export const TASK_STATES: TaskStateValue[] = ['proposal', 'active', 'completed', 'failed', 'cancelled'];
-export const TERMINAL_STATES: TaskStateValue[] = ['completed', 'failed', 'cancelled'];
-
-export const VALID_TRANSITIONS: Partial<Record<TaskStateValue, TaskStateValue[]>> = {
-  proposal: ['active', 'cancelled'],
-  active:   ['completed', 'failed', 'cancelled'],
-};
-
-export function isTerminal(state: string): boolean {
-  return TERMINAL_STATES.includes(state as TaskStateValue);
-}
-
-export function canTransitionTo(from: string, to: string): boolean {
-  if (isTerminal(from)) return false;
-  const allowed = VALID_TRANSITIONS[from as TaskStateValue];
-  if (!allowed) return false;
-  return allowed.includes(to as TaskStateValue);
-}
-
-export function normalizeState(state: string): string {
-  if (state === 'done') return TaskState.COMPLETED;
-  if (state === 'error') return TaskState.FAILED;
-  return state;
-}
-
-export function isValidState(state: string): boolean {
-  return TASK_STATES.includes(state as TaskStateValue);
-}
-
-// ── Shapes ────────────────────────────────────────────────────────────────────
-
-export interface PlanStep {
-  stepId: string;
-  description?: string;
-  order?: number;
-  status?: 'pending' | 'in_progress' | 'completed' | 'skipped';
-  result?: unknown;
-}
-
-export interface TaskHistoryEntry {
-  changeType: string;
-  [key: string]: unknown;
-}
-
-export interface AgreementParties {
-  creatorId?: string | null;
-  providerId?: string | null;
-  payerId?: string | null;
-  proposedToId?: string | null;
-}
-
-export interface AgreementTerms {
-  price?: number | null;
-  lifecycle?: string | null;
-  expiresAt?: string | null;
-  maxExecutions?: number | null;
-  description?: string | null;
-}
-
-export interface AgreementMoney {
-  price?: number | null;
-  paymentStatus?: string | null;
-}
-
-export interface AgreementProposal {
-  status: 'pending' | 'approved' | 'rejected' | null;
-  respondedBy?: string | null;
-  proposedAt?: string | null;
-  respondedAt?: string | null;
-}
-
-export const HistoryChangeType = {
-  CREATED:           'created',
-  STATE_CHANGED:     'state_changed',
-  PROCESSING_CHANGED: 'processing_changed',
-  PLAN_STEP_CHANGED: 'plan_step_changed',
-  PLAN_RESTRUCTURED: 'plan_restructured',
-  PLAN_ACKNOWLEDGED: 'plan_acknowledged',
-} as const;
-
-export type HistoryChangeTypeValue = (typeof HistoryChangeType)[keyof typeof HistoryChangeType];
-
-export interface Agreement {
-  agreementId: string;
-  taskId?: string | null;
-  rootAgreementId?: string | null;
-  parentAgreementId?: string | null;
-  parties: AgreementParties;
-  terms: AgreementTerms;
-  money: AgreementMoney;
-  proposal: AgreementProposal;
-  status: 'draft' | 'open' | 'active' | 'fulfilled' | 'cancelled' | 'refunded';
-  createdAt: string;
-  updatedAt: string;
-}
-
-export interface Task {
-  taskId: string;
-  description: string;
-  agreementId: string;
-  agreement?: Agreement | null;
-  state: TaskStateValue;
-  processing: boolean;
-  deleted: boolean;
-  result?: unknown;
-  errorMessage?: string | null;
-  createdAt: string;
-  updatedAt: string;
-  parentTaskId?: string | null;
-  rootTaskId?: string | null;
-  plan?: { steps?: PlanStep[] };
-  history?: TaskHistoryEntry[];
-}
-
-export interface TaskWithFlags extends Task {
-  creatorIsYou?: boolean;
-  providerIsYou?: boolean;
-  payerIsYou?: boolean;
-  proposedToIsYou?: boolean;
-}
-
-/** ⚠️ SYNC: Keep in sync with backend and api-client */
-export const OPEN_AGREEMENT_TARGET = 'everyone' as const;