@xopcai/xopc 0.0.180 → 0.0.187

package/dist/src/goals/types.d.ts

@@ -1,136 +0,0 @@
-import type { MediaRef } from '../media/types.js';
-export type GoalStatus = 'active' | 'paused' | 'blocked' | 'needs_input' | 'done' | 'archived';
-export type GoalPriority = 'low' | 'normal' | 'high';
-export type GoalSource = 'chat' | 'cli' | 'cron' | 'workflow' | 'channel' | 'api';
-export type GoalUiLocale = 'en' | 'zh';
-export type GoalChecklistStatus = 'pending' | 'completed' | 'impossible';
-export type GoalChecklistAddedBy = 'user' | 'judge';
-export type GoalRunStatus = 'running' | 'succeeded' | 'failed' | 'aborted';
-export type GoalRunVerdict = 'continue' | 'done' | 'blocked' | 'needs_input' | 'decompose';
-export interface Goal {
-    id: string;
-    outcomeId: string;
-    outcomeContractVersion: number;
-    title: string;
-    description?: string;
-    status: GoalStatus;
-    agentId: string;
-    priority: GoalPriority;
-    deadlineAt?: number;
-    createdAt: number;
-    updatedAt: number;
-    completedAt?: number;
-    archivedAt?: number;
-    activeSessionKey?: string;
-    currentRunId?: string;
-    nextAction?: string;
-    blockedReason?: string;
-    judgeModelRef?: string;
-    maxTurns: number;
-    turnsUsed: number;
-    uiLocale?: GoalUiLocale;
-    source: GoalSource;
-    projectId?: string;
-}
-export interface GoalChecklistItem {
-    id: string;
-    goalId: string;
-    text: string;
-    status: GoalChecklistStatus;
-    addedBy: GoalChecklistAddedBy;
-    addedAt: number;
-    completedAt?: number;
-    evidenceSummary?: string;
-    sortOrder: number;
-}
-export interface GoalRun {
-    id: string;
-    goalId: string;
-    sessionKey: string;
-    source: GoalSource;
-    status: GoalRunStatus;
-    startedAt: number;
-    finishedAt?: number;
-    verdict?: GoalRunVerdict;
-    reason?: string;
-    nextAction?: string;
-    assistantPreview?: string;
-    checklistProgress?: {
-        done: number;
-        total: number;
-    };
-    confidence?: number;
-    missingEvidence?: string[];
-    userQuestion?: string;
-    completedChecklistItemIds?: string[];
-}
-export interface GoalEvent {
-    id: string;
-    goalId: string;
-    runId?: string;
-    kind: string;
-    message: string;
-    data?: unknown;
-    createdAt: number;
-}
-export interface GoalEvidence {
-    id: string;
-    goalId: string;
-    runId?: string;
-    kind: 'file' | 'diff' | 'command' | 'test' | 'link' | 'message' | 'artifact';
-    title: string;
-    summary?: string;
-    uri?: string;
-    data?: unknown;
-    createdAt: number;
-}
-export type GoalContextAttachment = MediaRef;
-export interface GoalContextMessage {
-    goalId: string;
-    text: string;
-    attachments: GoalContextAttachment[];
-    createdAt: number;
-    updatedAt: number;
-}
-export interface GoalWithDetails extends Goal {
-    checklist: GoalChecklistItem[];
-    latestRun?: GoalRun;
-    contextMessage?: GoalContextMessage;
-}
-export interface GoalListQuery {
-    status?: GoalStatus | GoalStatus[];
-    agentId?: string;
-    sessionKey?: string;
-    projectId?: string;
-    limit?: number;
-    offset?: number;
-}
-export interface CreateGoalInput {
-    outcomeId: string;
-    outcomeContractVersion: number;
-    title: string;
-    description?: string;
-    agentId: string;
-    sessionKey?: string;
-    priority?: GoalPriority;
-    deadlineAt?: number;
-    judgeModelRef?: string;
-    maxTurns: number;
-    uiLocale?: GoalUiLocale;
-    source?: GoalSource;
-    projectId?: string;
-}
-export interface GoalJudgeDecision {
-    verdict: GoalRunVerdict;
-    reason: string;
-    nextAction?: string;
-    assistantPreview?: string;
-    checklistProgress?: {
-        done: number;
-        total: number;
-    };
-    confidence?: number;
-    missingEvidence?: string[];
-    userQuestion?: string;
-    completedChecklistItemIds?: string[];
-}

package/dist/src/goals/types.js

@@ -1 +0,0 @@
-export {};

package/dist/src/i18n/goals-bundle.d.ts

@@ -1,35 +0,0 @@
-import goalsEn from './locales/goals.en.json';
-import type { ServerLocale } from './locale.js';
-export type GoalsMessages = typeof goalsEn;
-export type JudgeReasonId = keyof GoalsMessages['judgeReason'];
-/** Canonical English strings for judge parse / API contract (from `goals.en.json`). */
-export declare const JUDGE_REASON_EN: {
-    empty_goal: string;
-    empty_response: string;
-    judge_model_not_configured: string;
-    judge_call_failed: string;
-    judge_returned_empty: string;
-    judge_reply_not_json: string;
-    no_reason_provided: string;
-    decompose_reply_not_json: string;
-    missing_items_array: string;
-    empty_checklist: string;
-    decompose_call_failed: string;
-};
-export declare function goalsMessages(locale: ServerLocale): GoalsMessages;
-export declare function goalsJudgeReason(id: JudgeReasonId, locale: ServerLocale): string;
-export declare function goalsJudgeResponseLanguageNote(locale: ServerLocale): string;
-export declare function goalsContinuationPlainTemplate(locale: ServerLocale): string;
-export declare function goalsContinuationChecklistTemplate(locale: ServerLocale): string;
-export declare function goalsChecklistProgressSuffix(done: number, total: number, locale: ServerLocale): string;
-export declare function goalsEvaluateCopy(locale: ServerLocale): {
-    pauseBudget: (turnsUsed: number, maxTurns: number) => string;
-    pauseParse: (failures: number) => string;
-    goalAchieved: (reason: string) => string;
-    continuingWithProgress: (turnsUsed: number, maxTurns: number, progressSuffix: string, reason: string) => string;
-    continuing: (turnsUsed: number, maxTurns: number, reason: string) => string;
-    checklistReady: (n: number) => string;
-    decomposedReason: (n: number) => string;
-    decomposeFallbackReason: (detail: string) => string;
-    noChecklistFallback: () => string;
-};

package/dist/src/i18n/goals-bundle.js

@@ -1,61 +0,0 @@
-import { formatI18n } from "./format.js";
-import goals_en_default, { judgeReason } from "./locales/goals.en.js";
-import goals_zh_default from "./locales/goals.zh.js";
-import { serverLocaleOrFallback } from "./locale.js";
-//#region src/i18n/goals-bundle.ts
-/** Canonical English strings for judge parse / API contract (from `goals.en.json`). */
-const JUDGE_REASON_EN = judgeReason;
-const byLocale = {
-	en: goals_en_default,
-	zh: goals_zh_default
-};
-function goalsMessages(locale) {
-	return byLocale[serverLocaleOrFallback(locale)];
-}
-function goalsJudgeReason(id, locale) {
-	return goalsMessages(locale).judgeReason[id] ?? judgeReason[id] ?? String(id);
-}
-function goalsJudgeResponseLanguageNote(locale) {
-	return goalsMessages(locale).judge.responseLanguageNote;
-}
-function goalsContinuationPlainTemplate(locale) {
-	return goalsMessages(locale).continuation.plain;
-}
-function goalsContinuationChecklistTemplate(locale) {
-	return goalsMessages(locale).continuation.checklist;
-}
-function goalsChecklistProgressSuffix(done, total, locale) {
-	if (total <= 0) return "";
-	return formatI18n(goalsMessages(locale).checklistProgressSuffix, {
-		done,
-		total
-	});
-}
-function goalsEvaluateCopy(locale) {
-	const ev = goalsMessages(locale).evaluate;
-	return {
-		pauseBudget: (turnsUsed, maxTurns) => formatI18n(ev.pauseBudget, {
-			turnsUsed,
-			maxTurns
-		}),
-		pauseParse: (failures) => formatI18n(ev.pauseParse, { failures }),
-		goalAchieved: (reason) => formatI18n(ev.goalAchieved, { reason }),
-		continuingWithProgress: (turnsUsed, maxTurns, progressSuffix, reason) => formatI18n(ev.continuingWithProgress, {
-			turnsUsed,
-			maxTurns,
-			progressSuffix,
-			reason
-		}),
-		continuing: (turnsUsed, maxTurns, reason) => formatI18n(ev.continuing, {
-			turnsUsed,
-			maxTurns,
-			reason
-		}),
-		checklistReady: (n) => formatI18n(ev.checklistReady, { n }),
-		decomposedReason: (n) => formatI18n(ev.decomposedReason, { n }),
-		decomposeFallbackReason: (detail) => formatI18n(ev.decomposeFallbackReason, { detail }),
-		noChecklistFallback: () => ev.noChecklistFallback
-	};
-}
-//#endregion
-export { JUDGE_REASON_EN, goalsChecklistProgressSuffix, goalsContinuationChecklistTemplate, goalsContinuationPlainTemplate, goalsEvaluateCopy, goalsJudgeReason, goalsJudgeResponseLanguageNote, goalsMessages };

package/dist/src/i18n/locales/goals.en.js

@@ -1,36 +0,0 @@
-//#region src/i18n/locales/goals.en.json
-var judgeReason = {
-	"empty_goal": "empty goal",
-	"empty_response": "empty response (nothing to evaluate)",
-	"judge_model_not_configured": "judge model not configured",
-	"judge_call_failed": "judge call failed",
-	"judge_returned_empty": "judge returned empty response",
-	"judge_reply_not_json": "judge reply was not JSON",
-	"no_reason_provided": "no reason provided",
-	"decompose_reply_not_json": "decompose reply was not JSON",
-	"missing_items_array": "missing items array",
-	"empty_checklist": "empty checklist",
-	"decompose_call_failed": "decompose call failed"
-};
-var goals_en_default = {
-	continuation: {
-		"plain": "[Continuing toward your standing goal]\nGoal: {{goal}}\n\nContinue working toward this goal. Take the next concrete step. If you believe the goal is complete, state so explicitly and stop. If you are blocked and need input from the user, say so clearly and stop.",
-		"checklist": "[Continuing toward your standing goal]\nGoal: {{goal}}\n\nChecklist progress ({{done}}/{{total}} done):\n{{checklist}}\n\nWork on the unchecked items above. Do not declare items done yourself — a judge marks them based on evidence in your output. If an item is genuinely impossible in this environment, explain why so the judge can mark it impossible. If you are blocked on a remaining item and need user input, say so clearly and stop."
-	},
-	judge: { "responseLanguageNote": "" },
-	judgeReason,
-	checklistProgressSuffix: " — {{done}}/{{total}} done",
-	evaluate: {
-		"pauseBudget": "⏸ Goal paused — {{turnsUsed}}/{{maxTurns}} turns used. Use /goal resume to keep going, or /goal clear to stop.",
-		"pauseParse": "⏸ Goal paused — the judge returned unparseable output {{failures}} turns in a row. Configure a stricter model under `goals.judgeModelRef` in your xopc config, then /goal resume.",
-		"goalAchieved": "✓ Goal achieved: {{reason}}",
-		"continuingWithProgress": "↻ Continuing toward goal ({{turnsUsed}}/{{maxTurns}}{{progressSuffix}}): {{reason}}",
-		"continuing": "↻ Continuing toward goal ({{turnsUsed}}/{{maxTurns}}): {{reason}}",
-		"checklistReady": "⊙ Checklist ready ({{n}} criteria). Use /subgoal to view or edit. Continuing...",
-		"decomposedReason": "decomposed into {{n}} items",
-		"decomposeFallbackReason": "decompose: {{detail}}",
-		"noChecklistFallback": "decompose produced no checklist"
-	}
-};
-//#endregion
-export { goals_en_default as default, judgeReason };

package/dist/src/i18n/locales/goals.zh.js

@@ -1,35 +0,0 @@
-//#region src/i18n/locales/goals.zh.json
-var goals_zh_default = {
-	continuation: {
-		"plain": "[继续完成你的持久目标]\n目标：{{goal}}\n\n请继续向该目标推进，采取下一步具体行动。若你认为目标已完成，请明确说明并停止。若被阻塞需要用户提供信息，请清楚说明并停止。",
-		"checklist": "[继续完成你的持久目标]\n目标：{{goal}}\n\n清单进度（{{done}}/{{total}} 项已完成）：\n{{checklist}}\n\n请针对上述未完成项继续推进。不要自行宣称某项已完成——由裁判根据你的输出判定。若某项在当前环境下确实无法完成，请说明原因以便裁判标记为无法完成。若在剩余项上被阻塞需要用户输入，请清楚说明并停止。"
-	},
-	judge: { "responseLanguageNote": "\n\n【语言要求】请仅用简体中文撰写 JSON 中的 reason 字段。若为分解清单，则每条 checklist item 的 text 也须为简体中文。JSON 键名与布尔值仍使用英文（如 done: true / false）。" },
-	judgeReason: {
-		"empty_goal": "目标为空",
-		"empty_response": "助手回复为空，无可评估内容",
-		"judge_model_not_configured": "未配置裁判模型",
-		"judge_call_failed": "裁判调用失败",
-		"judge_returned_empty": "裁判返回了空内容",
-		"judge_reply_not_json": "裁判返回内容不是合法 JSON",
-		"no_reason_provided": "未提供理由",
-		"decompose_reply_not_json": "分解结果不是合法 JSON",
-		"missing_items_array": "缺少 items 数组",
-		"empty_checklist": "清单为空",
-		"decompose_call_failed": "分解调用失败"
-	},
-	checklistProgressSuffix: "，{{done}}/{{total}} 项已完成",
-	evaluate: {
-		"pauseBudget": "⏸ 目标已暂停 — 已用 {{turnsUsed}}/{{maxTurns}} 轮。请使用 /goal resume 继续，或 /goal clear 停止。",
-		"pauseParse": "⏸ 目标已暂停 — 裁判连续 {{failures}} 次返回无法解析的输出。请在 xopc 配置的 goals.judgeModelRef 中换用更严格、更守格式的模型，然后执行 /goal resume。",
-		"goalAchieved": "✓ 目标已达：{{reason}}",
-		"continuingWithProgress": "↻ 继续推进目标（{{turnsUsed}}/{{maxTurns}} 轮{{progressSuffix}}）：{{reason}}",
-		"continuing": "↻ 继续推进目标（{{turnsUsed}}/{{maxTurns}} 轮）：{{reason}}",
-		"checklistReady": "⊙ 清单已就绪（共 {{n}} 条标准）。可使用 /subgoal 查看或编辑。正在继续…",
-		"decomposedReason": "已分解为 {{n}} 条验收标准",
-		"decomposeFallbackReason": "分解失败或未生成清单：{{detail}}",
-		"noChecklistFallback": "分解未产生清单"
-	}
-};
-//#endregion
-export { goals_zh_default as default };

package/dist/src/projects/goal-bind.d.ts

@@ -1,4 +0,0 @@
-export declare function bindGoalToProject(goalId: string, projectId: string): void;
-export declare function unbindGoalFromProject(goalId: string): void;
-export declare function listProjectGoalIds(projectId: string, limit?: number, offset?: number): string[];
-export declare function bindGoalsToProject(goalIds: string[], projectId: string): void;

package/dist/src/projects/goal-bind.js

@@ -1,38 +0,0 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
-//#region src/projects/goal-bind.ts
-function assertProjectExists(projectId) {
-	if (!getSqliteDatabase().prepare(`SELECT 1 FROM projects WHERE project_id = ?`).get(projectId)) throw new Error(`Project not found: ${projectId}`);
-}
-function assertGoalExists(goalId) {
-	if (!getSqliteDatabase().prepare(`SELECT 1 FROM goals WHERE goal_id = ?`).get(goalId)) throw new Error(`Goal not found: ${goalId}`);
-}
-function bindGoalToProject(goalId, projectId) {
-	assertProjectExists(projectId);
-	assertGoalExists(goalId);
-	runSqliteWriteTransaction((db) => {
-		const now = Date.now();
-		db.prepare(`UPDATE goals SET project_id = ?, updated_at = ? WHERE goal_id = ?`).run(projectId, now, goalId);
-		db.prepare(`UPDATE projects SET last_active_at = ?, updated_at = ? WHERE project_id = ?`).run(now, now, projectId);
-	});
-}
-function unbindGoalFromProject(goalId) {
-	assertGoalExists(goalId);
-	runSqliteWriteTransaction((db) => {
-		db.prepare(`UPDATE goals SET project_id = NULL, updated_at = ? WHERE goal_id = ?`).run(Date.now(), goalId);
-	});
-}
-function listProjectGoalIds(projectId, limit = 100, offset = 0) {
-	assertProjectExists(projectId);
-	return getSqliteDatabase().prepare(`SELECT goal_id FROM goals WHERE project_id = ? ORDER BY updated_at DESC LIMIT ? OFFSET ?`).all(projectId, Math.min(500, Math.max(1, Math.floor(limit))), Math.max(0, Math.floor(offset))).map((row) => row.goal_id);
-}
-function bindGoalsToProject(goalIds, projectId) {
-	assertProjectExists(projectId);
-	runSqliteWriteTransaction((db) => {
-		const now = Date.now();
-		const stmt = db.prepare(`UPDATE goals SET project_id = ?, updated_at = ? WHERE goal_id = ?`);
-		for (const goalId of goalIds) stmt.run(projectId, now, goalId);
-		db.prepare(`UPDATE projects SET last_active_at = ?, updated_at = ? WHERE project_id = ?`).run(now, now, projectId);
-	});
-}
-//#endregion
-export { bindGoalToProject, bindGoalsToProject, listProjectGoalIds, unbindGoalFromProject };

package/dist/src/session/abort-cutoff.d.ts

@@ -1,6 +0,0 @@
-/**
- * Webchat abort cutoff (OpenClaw-style): stale in-flight POSTs after /api/agent/abort
- * are ignored when the client sends `clientCreatedAtMs` from send time.
- */
-import type { SessionMetadata } from './types.js';
-export declare function shouldSkipWebchatInboundByAbortCutoff(meta: SessionMetadata | null | undefined, clientCreatedAtMs?: number): boolean;

package/dist/src/session/abort-cutoff.js

@@ -1,8 +0,0 @@
-//#region src/session/abort-cutoff.ts
-function shouldSkipWebchatInboundByAbortCutoff(meta, clientCreatedAtMs) {
-	if (!meta?.abortCutoffTimestamp) return false;
-	if (typeof clientCreatedAtMs !== "number" || !Number.isFinite(clientCreatedAtMs)) return false;
-	return clientCreatedAtMs <= meta.abortCutoffTimestamp;
-}
-//#endregion
-export { shouldSkipWebchatInboundByAbortCutoff };

package/dist/src/storage/sqlite/execution-receipt-repository.d.ts

@@ -1,146 +0,0 @@
-import { type ExecutionFailureCode, type ExecutionFailurePhase, type ExecutionRecoveryAction, type ExecutionVerification } from '../../agent/outcomes/execution-verifier.js';
-export type ExecutionReceiptStatus = 'running' | 'succeeded' | 'failed' | 'cancelled';
-export type ExecutionFeedbackOutcome = 'helpful' | 'not_helpful';
-export type ExecutionVerdict = 'achieved' | 'partial' | 'not_achieved';
-export type ExecutionReceiptOrigin = 'chat' | 'goal' | 'workflow' | 'automation' | 'browser' | 'proactive';
-export type ExecutionReceiptTrigger = 'user' | 'schedule' | 'webhook' | 'proactive' | 'retry';
-export interface ExecutionReceiptContext {
-    outcomeId?: string;
-    projectId?: string;
-    goalId?: string;
-    workItemId?: string;
-    origin?: ExecutionReceiptOrigin;
-    triggerKind?: ExecutionReceiptTrigger;
-    parentRunId?: string;
-    contextTraceId?: string;
-}
-export interface ExecutionContract {
-    objective: string;
-    deliverables: string[];
-    acceptanceCriteria: string[];
-    constraints: string[];
-    approvalRequired: string[];
-}
-export interface ExecutionEvidence {
-    kind: 'artifact' | 'test' | 'state' | 'source';
-    title: string;
-    summary: string;
-    uri?: string;
-    verifies?: string[];
-}
-export interface ExecutionReceipt {
-    runId: string;
-    sessionKey: string;
-    channel: string;
-    objective: string;
-    status: ExecutionReceiptStatus;
-    summary?: string;
-    contract?: ExecutionContract;
-    contractVersion?: number;
-    attempt: number;
-    strategy?: string;
-    evidence: ExecutionEvidence[];
-    verification: ExecutionVerification;
-    context: ExecutionReceiptContext;
-    nextAction?: string;
-    needsUser: boolean;
-    completionVerdict?: ExecutionVerdict;
-    completionVerdictSource?: 'system' | 'user';
-    correctionText?: string;
-    projectionVersion: number;
-    projectedAt?: number;
-    failure?: {
-        code: ExecutionFailureCode;
-        phase: ExecutionFailurePhase;
-        recoveryAction: ExecutionRecoveryAction;
-    };
-    feedback?: {
-        outcome: ExecutionFeedbackOutcome;
-        reason?: string;
-        needsCorrection?: boolean;
-        supportFit?: boolean;
-    };
-    startedAt: number;
-    completedAt?: number;
-    updatedAt: number;
-}
-export interface ExecutionReceiptMetrics {
-    total: number;
-    completed: number;
-    succeeded: number;
-    verified: number;
-    helpful: number;
-    notHelpful: number;
-    completionRate: number;
-    successRate: number;
-    verificationRate: number;
-    helpfulRate: number;
-}
-export declare function startExecutionReceipt(input: {
-    runId: string;
-    sessionKey: string;
-    channel: string;
-    objective: string;
-    context?: ExecutionReceiptContext;
-    contract?: ExecutionContract;
-    contractVersion?: number;
-    attempt?: number;
-    strategy?: string;
-    now?: number;
-}): ExecutionReceipt;
-export declare function completeExecutionReceipt(input: {
-    runId: string;
-    status: Exclude<ExecutionReceiptStatus, 'running'>;
-    summary: string;
-    now?: number;
-}): ExecutionReceipt | undefined;
-export declare function setExecutionVerdict(input: {
-    runId: string;
-    verdict: ExecutionVerdict;
-    correctionText?: string;
-    now?: number;
-}): ExecutionReceipt | undefined;
-export declare function markExecutionReceiptProjected(input: {
-    runId: string;
-    projectionVersion: number;
-    now?: number;
-}): ExecutionReceipt | undefined;
-export declare function listUnprojectedExecutionReceipts(input: {
-    projectionVersion: number;
-    limit?: number;
-}): ExecutionReceipt[];
-export declare function updateExecutionReceipt(input: {
-    runId: string;
-    contract?: ExecutionContract;
-    evidence?: ExecutionEvidence[];
-    summary?: string;
-    nextAction?: string | null;
-    needsUser?: boolean;
-    contextTraceId?: string | null;
-    now?: number;
-}): ExecutionReceipt | undefined;
-type ExecutionReceiptFeedbackInput = {
-    outcome: ExecutionFeedbackOutcome;
-    reason?: string;
-    needsCorrection?: boolean;
-    supportFit?: boolean;
-    now?: number;
-};
-export declare function setExecutionReceiptFeedback(input: ExecutionReceiptFeedbackInput & {
-    sessionKey: string;
-    assistantTimestamp: number;
-}): ExecutionReceipt | undefined;
-export declare function setExecutionReceiptFeedbackByRunId(input: ExecutionReceiptFeedbackInput & {
-    runId: string;
-}): ExecutionReceipt | undefined;
-export declare function getExecutionReceipt(runId: string): ExecutionReceipt | undefined;
-export declare function findExecutionReceiptForAssistant(sessionKey: string, assistantTimestamp: number): ExecutionReceipt | undefined;
-export declare function listExecutionReceipts(input?: {
-    outcomeId?: string;
-    sessionKey?: string;
-    projectId?: string;
-    workItemId?: string;
-    limit?: number;
-}): ExecutionReceipt[];
-export declare function summarizeExecutionReceipts(): ExecutionReceiptMetrics;
-export {};