@xopcai/xopc 0.0.180 → 0.0.187

package/dist/src/work/work-intake-service.js

@@ -1,171 +0,0 @@
-import { createLogger } from "../utils/logger/index.js";
-import { init_logger } from "../utils/logger.js";
-import { runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
-import { getSessionMetadata } from "../storage/sqlite/session-repository.js";
-import { getRelationshipSettings } from "../storage/sqlite/relationship-settings-repository.js";
-import "../storage/sqlite/index.js";
-import { GoalService } from "../goals/goal-service.js";
-import { OutcomeRepository } from "./outcome-repository.js";
-import "../goals/index.js";
-import { defineOutcomeContract } from "./outcome-contract-definition.js";
-import { WorkIntakeRepository } from "./work-intake-repository.js";
-import { createHash, randomUUID } from "node:crypto";
-//#region src/work/work-intake-service.ts
-init_logger();
-const INTAKE_TTL_MS = 900 * 1e3;
-const DEFAULT_NEXT_ACTION = "Complete the first verifiable result.";
-const log = createLogger("WorkIntake");
-function outcomeContractDraft(objective) {
-	return defineOutcomeContract(objective);
-}
-function requestFingerprint(input) {
-	return createHash("sha256").update(JSON.stringify({
-		objective: input.objective.trim(),
-		projectId: input.projectId ?? null,
-		sessionKey: input.sessionKey ?? null,
-		agentId: input.agentId ?? null
-	})).digest("hex");
-}
-var WorkIntakeService = class {
-	#goals = new GoalService();
-	#outcomes = new OutcomeRepository();
-	#repository = new WorkIntakeRepository();
-	constructor(projects, execution) {
-		this.projects = projects;
-		this.execution = execution;
-	}
-	propose(input) {
-		const fingerprint = requestFingerprint(input);
-		const existing = this.#repository.getByIdempotencyKey(input.idempotencyKey);
-		if (existing) {
-			if (existing.requestFingerprint !== fingerprint) throw new Error("Idempotency key was already used for a different work intake");
-			return existing.proposal;
-		}
-		const objective = input.objective.trim();
-		if (!objective) throw new Error("Objective is required");
-		const explicitProject = input.projectId ? this.projects.get(input.projectId) : void 0;
-		if (input.projectId && !explicitProject) throw new Error("Project not found");
-		const relationship = getRelationshipSettings();
-		const contract = outcomeContractDraft(objective);
-		const proposal = {
-			id: randomUUID(),
-			objective,
-			...explicitProject ? { projectId: explicitProject.id } : {},
-			planningContext: {
-				supportMode: relationship.supportMode,
-				proactiveEnabled: relationship.proactiveEnabled
-			},
-			outcomeContract: {
-				objective: contract.objective,
-				deliverables: contract.deliverables,
-				acceptanceCriteria: contract.acceptanceCriteria,
-				constraints: contract.constraints,
-				approvalRequired: contract.approvalRequired
-			},
-			expiresAt: Date.now() + INTAKE_TTL_MS
-		};
-		const stored = this.#repository.create({
-			idempotencyKey: input.idempotencyKey,
-			requestFingerprint: fingerprint,
-			proposal,
-			sessionKey: input.sessionKey,
-			agentId: input.agentId
-		});
-		if (stored.requestFingerprint !== fingerprint) throw new Error("Idempotency key was already used for a different work intake");
-		return stored.proposal;
-	}
-	confirm(input) {
-		const intake = this.#repository.get(input.proposalId);
-		if (!intake || intake.status === "expired" || intake.status === "cancelled") return void 0;
-		if (this.#repository.toConfirmedWork(intake)) return this._ensureExecution(intake);
-		const proposal = intake.proposal;
-		runSqliteWriteTransaction(() => {
-			const selectedProjectId = input.projectId ?? proposal.projectId;
-			const existingProject = selectedProjectId ? this.projects.get(selectedProjectId) : void 0;
-			if (selectedProjectId && !existingProject) throw new Error("Project not found");
-			const contract = proposal.outcomeContract;
-			const outcome = this.#outcomes.create({
-				objective: contract.objective,
-				deliverables: contract.deliverables,
-				acceptanceCriteria: contract.acceptanceCriteria,
-				constraints: contract.constraints,
-				approvalRequired: contract.approvalRequired,
-				createdBy: "user",
-				links: [...existingProject ? [{
-					kind: "project",
-					id: existingProject.id,
-					relation: "contains"
-				}] : [], ...intake.sessionKey ? [{
-					kind: "session",
-					id: intake.sessionKey,
-					relation: "originated_from"
-				}] : []]
-			});
-			const goal = this.#goals.create({
-				outcomeId: outcome.id,
-				outcomeContractVersion: outcome.latestContractVersion,
-				title: contract.objective,
-				description: proposal.objective,
-				projectId: existingProject?.id,
-				sessionKey: intake.sessionKey,
-				agentId: intake.agentId ?? existingProject?.defaultAgentId ?? "main",
-				source: "api"
-			});
-			this.#goals.update(goal.id, { nextAction: DEFAULT_NEXT_ACTION });
-			this.#outcomes.addLink(outcome.id, {
-				kind: "goal",
-				id: goal.id,
-				relation: "drives"
-			});
-			if (existingProject && intake.sessionKey && getSessionMetadata(intake.sessionKey)) this.projects.attachSession(intake.sessionKey, existingProject.id);
-			this.#repository.markConfirmed({
-				intakeId: proposal.id,
-				executionMode: input.executionMode,
-				projectId: existingProject?.id,
-				goalId: goal.id,
-				outcomeId: outcome.id,
-				sessionKey: intake.sessionKey
-			});
-		});
-		const confirmed = this.#repository.get(proposal.id);
-		if (!confirmed) throw new Error("Failed to confirm work intake");
-		return this._ensureExecution(confirmed);
-	}
-	reconcilePendingExecutions() {
-		if (!this.execution) return 0;
-		let reconciled = 0;
-		for (const intake of this.#repository.listPendingExecution()) if (this._ensureExecution(intake).execution.queueId) reconciled += 1;
-		return reconciled;
-	}
-	_ensureExecution(intake) {
-		if (intake.status !== "confirmed") throw new Error("Work intake is not confirmed");
-		if (intake.executionMode === "run_now" && !intake.queueId) try {
-			if (!this.execution || !intake.goalId || !intake.outcomeId) throw new Error("Work execution is unavailable");
-			const queued = this.execution.enqueue(intake.goalId, {
-				source: "api",
-				executionContext: {
-					outcomeId: intake.outcomeId,
-					contextTraceId: intake.proposal.id,
-					triggerKind: "user"
-				}
-			});
-			intake = this.#repository.setExecution({
-				intakeId: intake.proposal.id,
-				sessionKey: queued.sessionKey,
-				queueId: queued.id
-			});
-		} catch (err) {
-			const errorMessage = err instanceof Error ? err.message : String(err);
-			log.warn({
-				err,
-				intakeId: intake.proposal.id,
-				goalId: intake.goalId
-			}, `Work intake was confirmed but execution could not be queued: ${errorMessage}`);
-		}
-		const work = this.#repository.toConfirmedWork(intake);
-		if (!work) throw new Error("Failed to resolve confirmed work intake");
-		return work;
-	}
-};
-//#endregion
-export { WorkIntakeService };

package/dist/src/work/work-value-metrics-service.d.ts

@@ -1,4 +0,0 @@
-import type { WorkValueMetrics } from '@xopcai/gateway-contract';
-export declare class WorkValueMetricsService {
-    get(): WorkValueMetrics;
-}

package/dist/src/work/work-value-metrics-service.js

@@ -1,88 +0,0 @@
-import { getSqliteDatabase } from "../storage/sqlite/transaction.js";
-import "../storage/sqlite/index.js";
-//#region src/work/work-value-metrics-service.ts
-function ratio(numerator, denominator) {
-	return denominator > 0 ? numerator / denominator : 0;
-}
-function count(value) {
-	return Number(value ?? 0);
-}
-var WorkValueMetricsService = class {
-	get() {
-		const weekStart = Date.now() - 10080 * 60 * 1e3;
-		const intake = getSqliteDatabase().prepare(`SELECT
-        COUNT(*) AS total,
-        SUM(CASE WHEN status = 'proposed' THEN 1 ELSE 0 END) AS proposed,
-        SUM(CASE WHEN status = 'confirmed' THEN 1 ELSE 0 END) AS confirmed,
-        SUM(CASE WHEN status = 'expired' THEN 1 ELSE 0 END) AS expired,
-        SUM(CASE WHEN status = 'confirmed' AND execution_mode = 'run_now' THEN 1 ELSE 0 END) AS run_now,
-        SUM(CASE WHEN status = 'confirmed' AND execution_mode = 'create_only' THEN 1 ELSE 0 END) AS create_only,
-        SUM(CASE WHEN queue_id IS NOT NULL THEN 1 ELSE 0 END) AS queued,
-        SUM(CASE WHEN status = 'confirmed' AND execution_mode = 'run_now' AND queue_id IS NULL THEN 1 ELSE 0 END) AS pending_queue
-       FROM work_intakes`).get();
-		const outcomes = getSqliteDatabase().prepare(`SELECT
-        COUNT(*) AS total,
-        SUM(CASE WHEN completion_verdict = 'achieved' THEN 1 ELSE 0 END) AS achieved,
-        SUM(CASE WHEN completion_verdict = 'partial' THEN 1 ELSE 0 END) AS partial,
-        SUM(CASE WHEN completion_verdict = 'not_achieved' THEN 1 ELSE 0 END) AS not_achieved,
-        SUM(CASE WHEN completion_verdict_source = 'user' THEN 1 ELSE 0 END) AS user_corrected,
-        SUM(CASE WHEN completion_verdict = 'achieved'
-                    AND verification_status = 'passed'
-                    AND completion_verdict_source != 'user'
-                    AND COALESCE(feedback_outcome, 'helpful') != 'not_helpful'
-                  THEN 1 ELSE 0 END) AS trusted,
-        SUM(CASE WHEN updated_at >= ?
-                    AND completion_verdict = 'achieved'
-                    AND verification_status = 'passed'
-                    AND completion_verdict_source != 'user'
-                    AND COALESCE(feedback_outcome, 'helpful') != 'not_helpful'
-                  THEN 1 ELSE 0 END) AS weekly_trusted
-       FROM execution_receipts
-       WHERE status != 'running'
-         AND (project_id IS NOT NULL OR goal_id IS NOT NULL OR work_item_id IS NOT NULL)`).get(weekStart);
-		const confirmed = count(intake.confirmed);
-		const intakeTotal = count(intake.total);
-		const runNow = count(intake.run_now);
-		const queued = count(intake.queued);
-		const outcomeTotal = count(outcomes.total);
-		const achieved = count(outcomes.achieved);
-		const userCorrected = count(outcomes.user_corrected);
-		const trusted = count(outcomes.trusted);
-		const weeklyTrustedProgress = count(outcomes.weekly_trusted);
-		const weeklyActiveUsers = getSqliteDatabase().prepare(`SELECT 1 FROM sessions
-       WHERE COALESCE(last_interaction_at, updated_at) >= ?
-       LIMIT 1`).get(weekStart) !== void 0 ? 1 : 0;
-		return {
-			northStar: {
-				weeklyTrustedProgress,
-				weeklyActiveUsers,
-				trustedProgressPerWeeklyActiveUser: ratio(weeklyTrustedProgress, weeklyActiveUsers)
-			},
-			intake: {
-				total: intakeTotal,
-				proposed: count(intake.proposed),
-				confirmed,
-				expired: count(intake.expired),
-				runNow,
-				createOnly: count(intake.create_only),
-				queued,
-				pendingQueueRecovery: count(intake.pending_queue),
-				confirmationRate: ratio(confirmed, intakeTotal),
-				queueRate: ratio(queued, runNow)
-			},
-			outcomes: {
-				total: outcomeTotal,
-				achieved,
-				partial: count(outcomes.partial),
-				notAchieved: count(outcomes.not_achieved),
-				userCorrected,
-				achievementRate: ratio(achieved, outcomeTotal),
-				correctionRate: ratio(userCorrected, outcomeTotal),
-				trusted,
-				trustedRate: ratio(trusted, outcomeTotal)
-			}
-		};
-	}
-};
-//#endregion
-export { WorkValueMetricsService };

package/dist/src/work-items/agent-context.d.ts

@@ -1,7 +0,0 @@
-import type { AgentSourceContext } from '../agent/source-context/types.js';
-import type { MediaRef } from '../media/types.js';
-import type { WorkItem } from './types.js';
-export declare function buildWorkItemAgentContext(item: WorkItem, opts?: {
-    attachments?: readonly MediaRef[];
-    includeImages?: boolean;
-}): Promise<AgentSourceContext>;

package/dist/src/work-items/agent-context.js

@@ -1,73 +0,0 @@
-import { readMediaReferenceBase64 } from "../media/media-reference.js";
-//#region src/work-items/agent-context.ts
-const MAX_NATIVE_VISION_IMAGES = 6;
-const MAX_NATIVE_VISION_IMAGE_BYTES = 2 * 1024 * 1024;
-function contextLine(label, value) {
-	if (value === void 0 || value === null) return null;
-	const text = String(value).trim();
-	return text ? `${label}: ${text}` : null;
-}
-async function loadWorkItemNativeVisionImages(item) {
-	const images = [];
-	for (const attachment of item.attachments ?? []) {
-		if (attachment.type !== "image") continue;
-		if (!attachment.mimeType.toLowerCase().startsWith("image/")) continue;
-		if (attachment.size > MAX_NATIVE_VISION_IMAGE_BYTES) continue;
-		try {
-			const loaded = await readMediaReferenceBase64(attachment.mediaUri, MAX_NATIVE_VISION_IMAGE_BYTES);
-			images.push({
-				type: "image",
-				data: loaded.data,
-				mimeType: attachment.mimeType || loaded.mimeType
-			});
-			if (images.length >= MAX_NATIVE_VISION_IMAGES) break;
-		} catch {
-			continue;
-		}
-	}
-	return images;
-}
-function renderAttachmentLines(item, refs) {
-	if (!item.attachments?.length) return "";
-	return item.attachments.slice(0, 12).map((attachment, index) => {
-		const ref = refs?.[index];
-		return [
-			`- ${ref?.name ?? attachment.fileName} (${ref?.mimeType ?? attachment.mimeType}, ${ref?.size ?? attachment.size} bytes)`,
-			`  xopc-media-uri:${ref?.uri ?? attachment.mediaUri}`,
-			"  Use the read_media tool with the xopc-media-uri value when you need to inspect this attachment."
-		].join("\n");
-	}).join("\n");
-}
-async function buildWorkItemAgentContext(item, opts = {}) {
-	const links = item.links?.length ? item.links.slice(0, 12).map((link) => `- ${link.kind}: ${link.title || link.targetId}${link.statusSnapshot ? ` (${link.statusSnapshot})` : ""}`).join("\n") : "";
-	const attachments = renderAttachmentLines(item, opts.attachments);
-	const images = opts.includeImages === false ? [] : await loadWorkItemNativeVisionImages(item);
-	const text = [
-		"You are working inside a project work item. Treat this as the active task context, not as a new user message.",
-		"",
-		contextLine("Work item id", item.id),
-		contextLine("Project id", item.projectId),
-		contextLine("Title", item.title),
-		contextLine("Status", item.status),
-		contextLine("Priority", item.priority),
-		contextLine("Owner agent", item.ownerAgentId),
-		contextLine("Description", item.description),
-		contextLine("Next action", item.nextAction),
-		contextLine("Blocked reason", item.blockedReason),
-		item.dueAt ? contextLine("Due at", new Date(item.dueAt).toISOString()) : null,
-		links ? `Linked executions:\n${links}` : null,
-		attachments ? `Attachments:\n${attachments}` : null,
-		"",
-		"When you answer, keep the work item moving. If the discussion changes scope, call out the suggested work item update explicitly."
-	].filter(Boolean).join("\n");
-	return {
-		kind: "work_item",
-		sourceId: item.id,
-		version: String(item.updatedAt),
-		title: item.title,
-		text,
-		...images.length ? { images } : {}
-	};
-}
-//#endregion
-export { buildWorkItemAgentContext };

package/dist/src/work-items/index.d.ts

@@ -1,5 +0,0 @@
-export { WorkItemService, WORK_ITEM_ATTACHMENT_MAX_BYTES, WORK_ITEM_ATTACHMENT_MAX_COUNT, WORK_ITEM_ATTACHMENT_UPLOAD_BODY_MAX_BYTES, } from './work-item-service.js';
-export { WorkItemStore } from './work-item-store.js';
-export { WorkItemWorkflowJudge } from './work-item-workflow-judge.js';
-export { buildWorkItemAgentContext } from './agent-context.js';
-export type * from './types.js';

package/dist/src/work-items/index.js

@@ -1,5 +0,0 @@
-import { WorkItemStore } from "./work-item-store.js";
-import { WORK_ITEM_ATTACHMENT_MAX_BYTES, WORK_ITEM_ATTACHMENT_MAX_COUNT, WORK_ITEM_ATTACHMENT_UPLOAD_BODY_MAX_BYTES, WorkItemService } from "./work-item-service.js";
-import { WorkItemWorkflowJudge } from "./work-item-workflow-judge.js";
-import { buildWorkItemAgentContext } from "./agent-context.js";
-export { WORK_ITEM_ATTACHMENT_MAX_BYTES, WORK_ITEM_ATTACHMENT_MAX_COUNT, WORK_ITEM_ATTACHMENT_UPLOAD_BODY_MAX_BYTES, WorkItemService, WorkItemStore, WorkItemWorkflowJudge, buildWorkItemAgentContext };

package/dist/src/work-items/types.d.ts

@@ -1,112 +0,0 @@
-export type WorkItemStatus = 'backlog' | 'todo' | 'in_progress' | 'blocked' | 'needs_input' | 'in_review' | 'done' | 'cancelled';
-export type WorkItemPriority = 'urgent' | 'high' | 'normal' | 'low';
-export type WorkItemLinkKind = 'chat' | 'goal' | 'workflow_run' | 'automation' | 'note';
-export type WorkItemEventType = 'created' | 'updated' | 'status_changed' | 'archived' | 'attachment_added' | 'attachment_removed' | 'chat_started' | 'goal_created' | 'workflow_started' | 'automation_added' | 'link_added' | 'progress_note_added' | 'update_suggestion_created' | 'update_suggestion_applied' | 'update_suggestion_dismissed';
-export type WorkItemUpdateSuggestionStatus = 'pending' | 'applied' | 'dismissed';
-export type WorkItemUpdateSuggestionSourceKind = 'chat' | 'goal' | 'workflow_run' | 'automation';
-export interface WorkItem {
-    id: string;
-    projectId: string;
-    title: string;
-    description?: string;
-    status: WorkItemStatus;
-    priority: WorkItemPriority;
-    ownerAgentId?: string;
-    nextAction?: string;
-    blockedReason?: string;
-    dueAt?: number;
-    completedAt?: number;
-    archivedAt?: number;
-    createdAt: number;
-    updatedAt: number;
-    links?: WorkItemLink[];
-    attachments?: WorkItemAttachment[];
-}
-export interface WorkItemAttachment {
-    id: string;
-    workItemId: string;
-    mediaUri: string;
-    mediaId: string;
-    bucket: string;
-    type: 'image' | 'audio' | 'video' | 'file';
-    mimeType: string;
-    fileName: string;
-    size: number;
-    createdAt: number;
-}
-export interface WorkItemLink {
-    id: string;
-    workItemId: string;
-    kind: WorkItemLinkKind;
-    targetId: string;
-    title?: string;
-    statusSnapshot?: string;
-    createdAt: number;
-}
-export interface WorkItemEvent {
-    id: string;
-    workItemId: string;
-    type: WorkItemEventType;
-    payload?: unknown;
-    createdAt: number;
-}
-export interface WorkItemUpdateSuggestion {
-    id: string;
-    workItemId: string;
-    sourceKind: WorkItemUpdateSuggestionSourceKind;
-    sourceId: string;
-    status: WorkItemUpdateSuggestionStatus;
-    patch: Pick<UpdateWorkItemInput, 'status' | 'nextAction' | 'blockedReason'>;
-    progressNote?: string;
-    rationale?: string;
-    confidence?: number;
-    createdAt: number;
-    appliedAt?: number;
-    dismissedAt?: number;
-}
-export interface CreateWorkItemUpdateSuggestionInput {
-    sourceKind: WorkItemUpdateSuggestionSourceKind;
-    sourceId: string;
-    patch?: Pick<UpdateWorkItemInput, 'status' | 'nextAction' | 'blockedReason'>;
-    progressNote?: string;
-    rationale?: string;
-    confidence?: number;
-}
-export interface WorkItemListQuery {
-    status?: WorkItemStatus | WorkItemStatus[];
-    priority?: WorkItemPriority | WorkItemPriority[];
-    includeArchived?: boolean;
-    search?: string;
-    sortBy?: 'updatedAt' | 'createdAt' | 'priority' | 'status';
-    sortOrder?: 'asc' | 'desc';
-    limit?: number;
-    offset?: number;
-}
-export interface WorkItemListResult {
-    items: WorkItem[];
-    total: number;
-    limit: number;
-    offset: number;
-    hasMore: boolean;
-}
-export interface CreateWorkItemInput {
-    title: string;
-    description?: string;
-    status?: WorkItemStatus;
-    priority?: WorkItemPriority;
-    ownerAgentId?: string;
-    nextAction?: string;
-    blockedReason?: string;
-    dueAt?: number;
-}
-export interface UpdateWorkItemInput {
-    title?: string;
-    description?: string | null;
-    status?: WorkItemStatus;
-    priority?: WorkItemPriority;
-    ownerAgentId?: string | null;
-    nextAction?: string | null;
-    blockedReason?: string | null;
-    dueAt?: number | null;
-    archivedAt?: number | null;
-}

package/dist/src/work-items/types.js

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

package/dist/src/work-items/work-item-service.d.ts

@@ -1,36 +0,0 @@
-import type { ProactiveSignalPublisher } from '../proactive/events/publisher.js';
-import { WorkItemStore } from './work-item-store.js';
-import type { CreateWorkItemUpdateSuggestionInput, CreateWorkItemInput, UpdateWorkItemInput, WorkItem, WorkItemAttachment, WorkItemEvent, WorkItemLink, WorkItemListQuery, WorkItemListResult, WorkItemUpdateSuggestion, WorkItemUpdateSuggestionStatus } from './types.js';
-export declare const WORK_ITEM_ATTACHMENT_MAX_BYTES: number;
-export declare const WORK_ITEM_ATTACHMENT_MAX_COUNT = 10;
-export declare const WORK_ITEM_ATTACHMENT_UPLOAD_BODY_MAX_BYTES: number;
-export declare class WorkItemService {
-    private readonly store;
-    private readonly signals?;
-    constructor(store?: WorkItemStore, signals?: ProactiveSignalPublisher);
-    listProjectWorkItems(projectId: string, query?: WorkItemListQuery): WorkItemListResult;
-    listWorkItems(query?: WorkItemListQuery): WorkItemListResult;
-    createProjectWorkItem(projectId: string, input: CreateWorkItemInput): WorkItem;
-    getWorkItem(id: string): WorkItem | null;
-    updateWorkItem(id: string, patch: UpdateWorkItemInput): WorkItem | null;
-    addLink(workItemId: string, input: Omit<WorkItemLink, 'id' | 'workItemId' | 'createdAt'>, eventType?: Parameters<WorkItemStore['addEvent']>[1]): WorkItemLink | null;
-    listEvents(workItemId: string): WorkItemEvent[];
-    listAttachments(workItemId: string): WorkItemAttachment[] | null;
-    addAttachment(workItemId: string, file: {
-        name: string;
-        buffer: Buffer;
-        mimeType: string;
-    }): Promise<WorkItemAttachment | null>;
-    readAttachment(workItemId: string, attachmentId: string): Promise<{
-        attachment: WorkItemAttachment;
-        buffer: Buffer;
-    } | null>;
-    removeAttachment(workItemId: string, attachmentId: string): Promise<WorkItemAttachment | null>;
-    createUpdateSuggestion(workItemId: string, input: CreateWorkItemUpdateSuggestionInput): WorkItemUpdateSuggestion | null;
-    listUpdateSuggestions(workItemId: string, status?: WorkItemUpdateSuggestionStatus): WorkItemUpdateSuggestion[];
-    applyUpdateSuggestion(id: string): {
-        item: WorkItem;
-        suggestion: WorkItemUpdateSuggestion;
-    } | null;
-    dismissUpdateSuggestion(id: string): WorkItemUpdateSuggestion | null;
-}