actoviq-agent-sdk 0.4.11 → 0.4.13

package/dist/src/goal/goalService.d.ts

@@ -13,7 +13,7 @@
  * snapshot. All timestamps come from an injected clock so tests are deterministic.
  */
 import { type GoalSessionPort } from './goalStore.js';
-import type { Goal, GoalBudget, GoalMutationResult, GoalStatus } from './types.js';
+import type { Goal, GoalBudget, GoalEvidence, GoalMutationResult, GoalStatus, GoalTurnReceipt, GoalWorkItemClass, GoalWorkItemPriority, GoalWorkItemRole } from './types.js';
 /** Clock function used so tests can be deterministic. */
 export type GoalClock = () => string;
 export interface GoalServiceOptions {
@@ -36,6 +36,46 @@ export interface BlockGoalInput {
     turn?: number;
     expectedRevision?: number;
 }
+export interface SettleGoalTurnInput {
+    receipt: GoalTurnReceipt;
+    evidence: GoalEvidence[];
+    observedRefs?: string[];
+    /** Compatibility override for trusted runtime callers; normal settlement derives this. */
+    completionAccepted?: boolean;
+    replan?: {
+        trigger: string;
+        frontierFingerprint: string;
+        deltaRecorded: boolean;
+    };
+}
+export interface PlanGoalItemInput {
+    id?: string;
+    role?: GoalWorkItemRole;
+    priority?: GoalWorkItemPriority;
+    taskClass?: GoalWorkItemClass;
+    actionKind?: string;
+    text: string;
+    dependsOn?: string[];
+    successorOf?: string;
+    resumeWhen?: string;
+    roleScopes?: string[];
+    excludedAgentIds?: string[];
+}
+export interface PlanGoalInput {
+    items: PlanGoalItemInput[];
+    replace?: boolean;
+    reason?: string;
+    expectedRevision?: number;
+}
+export interface RequestGoalWorkItemUpdateInput {
+    workItemId: string;
+    status: 'open' | 'done' | 'deferred' | 'cancelled';
+    note: string;
+    evidenceRefs?: string[];
+    noFollowupReason?: string;
+    resumeWhen?: string;
+    expectedRevision?: number;
+}
 /** Result of a status transition used by /goal pause|resume|clear in the UI. */
 export type GoalTransitionResult = GoalMutationResult;
 export declare class GoalService {
@@ -59,6 +99,23 @@ export declare class GoalService {
      * The runtime calls this at the end of each turn.
      */
     progress(input: ProgressGoalInput): Promise<GoalMutationResult>;
+    /** Replace or extend the ordered executable frontier with a validated plan. */
+    plan(input: PlanGoalInput): Promise<GoalMutationResult>;
+    /** Mark the selected executable item as running before the model request. */
+    beginWorkItem(workItemId: string): Promise<GoalMutationResult>;
+    /** Force the next Goal turn into bounded replanning. */
+    forceReplan(reason?: string): Promise<GoalMutationResult>;
+    /**
+     * Point the existing goal at a new objective. Budget, evidence, and receipts
+     * carry over — only the objective changes — and the frontier is replanned so
+     * the agent re-derives the work for it. Used when the operator edits the
+     * objective of a goal that is already under way.
+     */
+    retarget(objective: string): Promise<GoalMutationResult>;
+    /** Queue a model-authored work-item transition for runtime settlement. */
+    requestWorkItemUpdate(input: RequestGoalWorkItemUpdateInput): Promise<GoalMutationResult>;
+    /** Resolve a user-owned gate with runtime-owned user evidence. */
+    answerUserGate(workItemId: string, answer: string): Promise<GoalMutationResult>;
     /**
      * Report a blocked turn. Runtime-only: requires a reason. The Goal stays
      * active for the first two reports and becomes blocked only when the same
@@ -69,17 +126,26 @@ export declare class GoalService {
      * Mark the goal complete. Runtime-only: requires evidence that the
      * completion criteria are met. The UI must not call this directly.
      */
+    requestCompletion(evidence: {
+        note: string;
+        evidenceRefs?: string[];
+        expectedRevision?: number;
+    }): Promise<GoalMutationResult>;
+    /** @deprecated Completion is now a runtime-settled request. */
     complete(evidence: {
         note: string;
+        evidenceRefs?: string[];
         expectedRevision?: number;
     }): Promise<GoalMutationResult>;
+    /** Settle one completed runtime turn and atomically account its usage. */
+    settleTurn(input: SettleGoalTurnInput): Promise<GoalMutationResult>;
     /**
      * UI-driven status transition for pause/resume. These do not require
      * evidence (they are steering, not completion). `complete` and `blocked`
      * are NOT exposed here - only the runtime may set those, via `complete()`
      * and `block()`.
      */
-    transition(target: 'paused' | 'active'): Promise<GoalTransitionResult>;
+    transition(target: 'paused' | 'active' | 'cancelled'): Promise<GoalTransitionResult>;
     /** Update the objective/criteria text (steering). Revision-bumped. */
     revise(input: {
         objective?: string;

package/dist/src/goal/goalService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"goalService.d.ts","sourceRoot":"","sources":["../../../src/goal/goalService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,IAAI,EACJ,UAAU,EAEV,kBAAkB,EAClB,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,yDAAyD;AACzD,MAAM,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC;AAErC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,eAAe,CAAC;IACtB,GAAG,CAAC,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,gFAAgF;AAChF,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAItD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;gBAEpB,OAAO,EAAE,kBAAkB;IAKvC,gEAAgE;IAChE,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE;QACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACnE,cAAc,CAAC,CACb,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KACrC,GAAG,WAAW;IAIf,qEAAqE;IAC/D,IAAI,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAIlC,qDAAqD;IAC/C,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBnD,+DAA+D;IACzD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;OAGG;IACG,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAyCrE;;;;OAIG;IACG,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA2C/D;;;OAGG;IACG,QAAQ,CAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiClG;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA6B5E,sEAAsE;IAChE,MAAM,CAAC,KAAK,EAAE;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAkChC;AAkCD,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAOzD"}
+{"version":3,"file":"goalService.d.ts","sourceRoot":"","sources":["../../../src/goal/goalService.ts"],"names":[],"mappings":"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"}