@lotagate/cli 0.1.23 → 0.1.25

package/dist/domain/memory/memory-search.js

@@ -0,0 +1,2 @@
+const _=2,x=1.2,S=.75;function b(e){const n=new Map,c={};let u=0;for(const r of e){const t=new Map;for(const s of h(r))t.set(s,(t.get(s)??0)+1);const o=Object.fromEntries(t.entries()),i=Object.values(o).reduce((s,m)=>s+m,0);c[r.id]={id:r.id,termFrequency:o,length:i},u+=i;for(const s of t.keys()){const m=n.get(s)??new Set;m.add(r.id),n.set(s,m)}}const a=Object.fromEntries([...n.entries()].map(([r,t])=>[r,[...t].sort()])),l=Object.fromEntries(Object.entries(a).map(([r,t])=>[r,t.length]));return{documents:c,postings:a,documentFrequency:l,averageDocumentLength:e.length===0?0:u/e.length}}function y(e,n,c){if(c.maximum<=0)return[];const u=d(c.text);if(u.length===0)return[];const a=new Set;for(const t of u)for(const o of n.postings[t]??[])a.add(o);const l=Object.keys(n.documents).length,r=[...a].flatMap(t=>{const o=e[t],i=n.documents[t];if(o===void 0||i===void 0||!g(o))return[];const s=M(i,u,n,l);return s>0?[{record:o,lexicalScore:s,rank:0}]:[]});return r.sort((t,o)=>o.lexicalScore-t.lexicalScore||o.record.updatedAt.localeCompare(t.record.updatedAt)||t.record.id.localeCompare(o.record.id)),r.slice(0,c.maximum).map((t,o)=>({...t,rank:o+1}))}function p(e){return e.normalize("NFKC").toLocaleLowerCase()}function d(e){const n=p(e),c=n.normalize("NFD").replace(/[\u0300-\u036f]/gu,"");return[...new Set([...f(n),...f(c)])]}function g(e,n=Date.now()){return e.state==="active"&&(e.expiresAt===void 0||Date.parse(e.expiresAt)>n)}function h(e){return d([e.statement,e.rationale??"",...e.topics].join(`
+`))}function f(e){return e.split(/[^\p{L}\p{N}_-]+/u).filter(n=>n.length>=2)}function M(e,n,c,u){return c.averageDocumentLength<=0||e.length<=0?0:n.reduce((a,l)=>{const r=e.termFrequency[l]??0,t=c.documentFrequency[l]??0;if(r===0||t===0)return a;const o=Math.log(1+(u-t+.5)/(t+.5)),i=r+1.2*(1-.75+.75*e.length/c.averageDocumentLength);return a+o*r*(1.2+1)/i},0)}export{b as buildMemorySearchIndex,g as isMemoryRetrievable,p as normalizeSearchText,y as searchMemoryIndex,d as uniqueTokens};

package/dist/domain/memory/memory.d.ts

@@ -0,0 +1,48 @@
+import { type MemoryKind } from './memory-kinds.js';
+export { MEMORY_KINDS, isMemoryKind } from './memory-kinds.js';
+export type { MemoryKind } from './memory-kinds.js';
+export declare const MEMORY_SCHEMA_VERSION: 2;
+export declare const MEMORY_STATES: readonly ["active", "superseded", "expired"];
+export declare const MEMORY_SOURCES: readonly ["user-explicit", "host-evidence", "model-inferred", "imported"];
+export type MemoryState = typeof MEMORY_STATES[number];
+export type MemorySource = typeof MEMORY_SOURCES[number];
+export interface MemoryRecord {
+    readonly id: string;
+    readonly kind: MemoryKind;
+    readonly state: MemoryState;
+    readonly statement: string;
+    readonly rationale?: string;
+    readonly topics: readonly string[];
+    readonly source: MemorySource;
+    readonly evidenceRefs: readonly string[];
+    readonly supersedes: readonly string[];
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly expiresAt?: string;
+    readonly lastRetrievedAt?: string;
+    readonly retrievalCount: number;
+}
+export interface MemoryDraft {
+    readonly kind: MemoryKind;
+    readonly state?: MemoryState;
+    readonly statement: string;
+    readonly rationale?: string;
+    readonly topics?: readonly string[];
+    readonly source?: MemorySource;
+    readonly evidenceRefs?: readonly string[];
+    readonly supersedes?: readonly string[];
+    readonly expiresAt?: string;
+}
+export interface MemoryBundle {
+    readonly schemaVersion: typeof MEMORY_SCHEMA_VERSION;
+    readonly exportedAt: string;
+    readonly records: readonly MemoryRecord[];
+}
+export declare function isMemoryState(value: unknown): value is MemoryState;
+export declare function isMemorySource(value: unknown): value is MemorySource;
+export declare function normalizeMemoryDraft(input: MemoryDraft): MemoryDraft;
+export declare function normalizeMemoryRecord(value: unknown): MemoryRecord;
+export declare function normalizeMemoryBundle(value: unknown): MemoryBundle;
+export declare function memoryRecordFromDraft(id: string, draft: MemoryDraft, timestamp: string): MemoryRecord;
+/** Returns the record state visible to callers without rewriting the journal. */
+export declare function effectiveMemoryRecord(record: MemoryRecord, now?: number): MemoryRecord;

package/dist/domain/memory/memory.js

@@ -0,0 +1 @@
+import{CliError as M}from"../errors/cli-error.js";import{CLI_ERROR_CODES as g}from"../errors/error-codes.js";import{RESOURCE_LIMITS as n}from"../runtime/resource-limits.js";import{findUnexpectedRecordKey as c,isRecord as f}from"../validation/record-schema.js";import{isMemoryKind as p}from"./memory-kinds.js";import{MEMORY_KINDS as U,isMemoryKind as q}from"./memory-kinds.js";const y=2,l=["active","superseded","expired"],w=["user-explicit","host-evidence","model-inferred","imported"];function u(e){return typeof e=="string"&&l.includes(e)}function A(e){return typeof e=="string"&&w.includes(e)}function S(e){const r=c(e,["kind","state","statement","rationale","topics","source","evidenceRefs","supersedes","expiresAt"]);if(r!==void 0)throw o(`Unsupported memory draft field: ${r}.`);return{kind:m(e.kind,p,"memory kind"),...e.state===void 0?{}:{state:m(e.state,u,"memory state")},statement:d(e.statement,n.memoryStatementBytes,"memory statement"),...e.rationale===void 0?{}:{rationale:d(e.rationale,n.memoryRationaleBytes,"memory rationale")},topics:x(e.topics??[]),source:e.source===void 0?"model-inferred":m(e.source,A,"memory source"),evidenceRefs:R(e.evidenceRefs??[]),supersedes:h(e.supersedes??[],"memory supersedes"),...e.expiresAt===void 0?{}:{expiresAt:s(e.expiresAt,"memory expiresAt")}}}function E(e){if(!f(e))throw o("Memory record must be an object.");const r=c(e,["id","kind","state","statement","rationale","topics","source","evidenceRefs","supersedes","createdAt","updatedAt","expiresAt","lastRetrievedAt","retrievalCount"]);if(r!==void 0)throw o(`Unsupported memory record field: ${r}.`);return{id:a(e.id),kind:m(e.kind,p,"memory kind"),state:m(e.state,u,"memory state"),statement:d(e.statement,n.memoryStatementBytes,"memory statement"),topics:x(e.topics),source:m(e.source,A,"memory source"),evidenceRefs:R(e.evidenceRefs),supersedes:h(e.supersedes,"memory supersedes"),createdAt:s(e.createdAt,"memory createdAt"),updatedAt:s(e.updatedAt,"memory updatedAt"),retrievalCount:b(e.retrievalCount,"memory retrievalCount"),...e.rationale===void 0?{}:{rationale:d(e.rationale,n.memoryRationaleBytes,"memory rationale")},...e.expiresAt===void 0?{}:{expiresAt:s(e.expiresAt,"memory expiresAt")},...e.lastRetrievedAt===void 0?{}:{lastRetrievedAt:s(e.lastRetrievedAt,"memory lastRetrievedAt")}}}function N(e){if(!f(e))throw o("Memory bundle must be an object.");const r=c(e,["schemaVersion","exportedAt","records"]);if(r!==void 0)throw o(`Unsupported memory bundle field: ${r}.`);if(e.schemaVersion!==y)throw o("Unsupported memory bundle schema version.");if(!Array.isArray(e.records)||e.records.length>n.memoryRecords)throw o("Memory bundle records are invalid or exceed the supported limit.");return{schemaVersion:y,exportedAt:s(e.exportedAt,"memory exportedAt"),records:e.records.map(i=>E(i))}}function $(e,r,i){const t=S(r);return{id:a(e),kind:t.kind,state:t.state??"active",statement:t.statement,topics:t.topics??[],source:t.source??"model-inferred",evidenceRefs:t.evidenceRefs??[],supersedes:t.supersedes??[],createdAt:s(i,"memory timestamp"),updatedAt:s(i,"memory timestamp"),retrievalCount:0,...t.rationale===void 0?{}:{rationale:t.rationale},...t.expiresAt===void 0?{}:{expiresAt:t.expiresAt}}}function B(e,r=Date.now()){return e.state==="active"&&e.expiresAt!==void 0&&Date.parse(e.expiresAt)<=r?{...e,state:"expired"}:e}function x(e){if(!Array.isArray(e)||e.length>n.memoryTopics||e.some(r=>typeof r!="string"))throw o("Memory topics are invalid.");return[...new Set(e.map(r=>r.trim()).filter(r=>r.length>0).map(r=>d(r,n.memoryTopicBytes,"memory topic")))].sort()}function R(e){if(!Array.isArray(e)||e.length>n.memoryEvidenceReferences||e.some(r=>typeof r!="string"))throw o("Memory evidence references are invalid.");return I(e,n.memoryEvidenceReferenceBytes,"memory evidence reference")}function h(e,r){if(!Array.isArray(e)||e.length>n.memorySupersedes||e.some(i=>typeof i!="string"))throw o(`${r} are invalid.`);return[...new Set(e.map(i=>a(i)))]}function I(e,r,i){return[...new Set(e.map(t=>t.trim()).map(t=>d(t,r,i)))]}function m(e,r,i){if(!r(e))throw o(`Invalid ${i}.`);return e}function d(e,r,i){if(typeof e!="string"||e.trim().length===0||Buffer.byteLength(e,"utf8")>r)throw o(`Invalid ${i}.`);return e.trim()}function a(e){if(typeof e!="string"||!/^[A-Za-z0-9_-]{1,128}$/u.test(e))throw o("Invalid memory id.");return e}function s(e,r){if(typeof e!="string"||Number.isNaN(Date.parse(e)))throw o(`Invalid ${r}.`);return e}function b(e,r){if(typeof e!="number"||!Number.isSafeInteger(e)||e<0)throw o(`Invalid ${r}.`);return e}function o(e){return new M(g.MEMORY_INVALID,e,{category:"memory",userMessage:e})}export{U as MEMORY_KINDS,y as MEMORY_SCHEMA_VERSION,w as MEMORY_SOURCES,l as MEMORY_STATES,B as effectiveMemoryRecord,q as isMemoryKind,A as isMemorySource,u as isMemoryState,$ as memoryRecordFromDraft,N as normalizeMemoryBundle,S as normalizeMemoryDraft,E as normalizeMemoryRecord};

package/dist/domain/orchestration/goal.d.ts

@@ -0,0 +1,58 @@
+export type GoalStatus = 'active' | 'paused' | 'completed' | 'blocked' | 'budget_limited' | 'usage_limited';
+export type GoalDecision = 'continue' | 'complete' | 'blocked' | 'budget_limited' | 'usage_limited';
+export interface GoalEvaluation {
+    decision: GoalDecision;
+    reason: string;
+    evidence: readonly string[];
+    timestamp: string;
+    evaluatorModel?: string;
+}
+export interface GoalUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    modelCalls: number;
+    estimated: boolean;
+}
+export interface GoalUsageDelta {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    modelCalls?: number;
+    estimated?: boolean;
+}
+export interface GoalState {
+    id: string;
+    sessionId: string;
+    objective: string;
+    status: GoalStatus;
+    createdAt: string;
+    updatedAt: string;
+    startedAt: string;
+    turns: number;
+    evaluatorRuns: number;
+    usage: GoalUsage;
+    tokenBudget?: number;
+    maxTurns?: number;
+    maxDurationMs?: number;
+    lastEvaluation?: GoalEvaluation;
+    lastError?: string;
+}
+export interface CreateGoalInput {
+    objective: string;
+    tokenBudget?: number;
+    maxTurns?: number;
+    maxDurationMs?: number;
+}
+export declare function validateGoalInput(input: CreateGoalInput): CreateGoalInput;
+/** Identifies journal events that must carry a complete goal snapshot. */
+export declare function isGoalEventType(value: string): boolean;
+/** Validates the complete durable goal state before it controls execution limits. */
+export declare function isGoalState(value: unknown): value is GoalState;
+/** Validates the durable evaluator result embedded in a goal snapshot. */
+export declare function isGoalEvaluation(value: unknown): value is GoalEvaluation;
+/** Validates the data payload written by a durable goal lifecycle event. */
+export declare function isPersistedGoalEventData(value: unknown): boolean;
+export declare function transitionGoal(state: GoalState, status: GoalStatus): GoalState;
+export declare function addGoalUsage(current: GoalUsage, delta: GoalUsageDelta): GoalUsage;
+export declare const EMPTY_GOAL_USAGE: GoalUsage;

package/dist/domain/orchestration/goal.js

@@ -0,0 +1 @@
+import{RESOURCE_LIMITS as n}from"../runtime/resource-limits.js";const m=new Set(["goal.created","goal.replaced","goal.paused","goal.resumed","goal.evaluated","goal.completed","goal.blocked","goal.budget_limited","goal.usage_limited","goal.usage_recorded","goal.cleared","goal.turn.started"]);function x(t){const e=t.objective.trim();if(e.length===0||e.length>16384||/[\0\r\n]/u.test(e))throw new Error("Goal objective must contain between 1 and 16384 printable characters.");for(const[i,r]of Object.entries(t))if(!(i==="objective"||r===void 0)&&(!Number.isSafeInteger(r)||r<=0))throw new Error(`Goal limit ${i} must be a positive integer.`);if(t.maxDurationMs!==void 0&&t.maxDurationMs>n.goalMaximumMaxDurationMs)throw new Error("Goal maxDurationMs cannot exceed 8 hours.");return{objective:e,...t.tokenBudget===void 0?{}:{tokenBudget:t.tokenBudget},...t.maxTurns===void 0?{}:{maxTurns:t.maxTurns},...t.maxDurationMs===void 0?{}:{maxDurationMs:t.maxDurationMs}}}function G(t){return m.has(t)}function c(t){return a(t)?typeof t.id=="string"&&typeof t.sessionId=="string"&&E(t.objective)&&p(t.status)&&d(t.createdAt)&&d(t.updatedAt)&&d(t.startedAt)&&o(t.turns)&&o(t.evaluatorRuns)&&b(t.usage)&&f(t.tokenBudget)&&f(t.maxTurns)&&y(t.maxDurationMs)&&T(t.lastEvaluation)&&(t.lastError===void 0||typeof t.lastError=="string"&&Buffer.byteLength(t.lastError,"utf8")<=n.goalReasonBytes):!1}function u(t){return a(t)?l(t.decision)&&typeof t.reason=="string"&&Buffer.byteLength(t.reason,"utf8")<=n.goalReasonBytes&&Array.isArray(t.evidence)&&t.evidence.length<=n.goalEvidenceItems&&t.evidence.every(e=>typeof e=="string"&&Buffer.byteLength(e,"utf8")<=n.goalEvidenceBytes)&&d(t.timestamp)&&(t.evaluatorModel===void 0||typeof t.evaluatorModel=="string"):!1}function M(t){return!a(t)||!c(t.goal)?!1:t.evaluation===void 0||u(t.evaluation)}function h(t,e){if(t.status==="completed"||t.status==="blocked"||t.status==="budget_limited"||t.status==="usage_limited")throw new Error(`Cannot transition a terminal goal from ${t.status}.`);if(e==="active"&&t.status!=="paused")throw new Error(`Cannot resume a goal from ${t.status}.`);if(e==="paused"&&t.status!=="active")throw new Error(`Cannot pause a goal from ${t.status}.`);return{...t,status:e,updatedAt:new Date().toISOString()}}function S(t,e){const i=s(t.inputTokens+(e.inputTokens??0)),r=s(t.outputTokens+(e.outputTokens??0)),g=s(t.totalTokens+(e.totalTokens??(e.inputTokens??0)+(e.outputTokens??0)));return{inputTokens:i,outputTokens:r,totalTokens:g,modelCalls:s(t.modelCalls+(e.modelCalls??0)),estimated:t.estimated||e.estimated===!0}}const _=Object.freeze({inputTokens:0,outputTokens:0,totalTokens:0,modelCalls:0,estimated:!1});function s(t){return Number.isSafeInteger(t)&&t>=0?t:Number.MAX_SAFE_INTEGER}function a(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}function p(t){return t==="active"||t==="paused"||t==="completed"||t==="blocked"||t==="budget_limited"||t==="usage_limited"}function l(t){return t==="continue"||t==="complete"||t==="blocked"||t==="budget_limited"||t==="usage_limited"}function b(t){return a(t)?o(t.inputTokens)&&o(t.outputTokens)&&o(t.totalTokens)&&o(t.modelCalls)&&typeof t.estimated=="boolean":!1}function T(t){return t===void 0||u(t)}function f(t){return t===void 0||typeof t=="number"&&Number.isSafeInteger(t)&&t>0}function y(t){return t===void 0||typeof t=="number"&&Number.isSafeInteger(t)&&t>0&&t<=n.goalMaximumMaxDurationMs}function o(t){return typeof t=="number"&&Number.isSafeInteger(t)&&t>=0}function d(t){return typeof t=="string"&&Number.isFinite(Date.parse(t))}function E(t){return typeof t=="string"&&t.trim().length>0&&t.length<=n.goalObjectiveBytes&&!/[\0\r\n]/u.test(t)}export{_ as EMPTY_GOAL_USAGE,S as addGoalUsage,u as isGoalEvaluation,G as isGoalEventType,c as isGoalState,M as isPersistedGoalEventData,h as transitionGoal,x as validateGoalInput};

package/dist/domain/orchestration/subagent-identity.d.ts

@@ -0,0 +1,2 @@
+/** Returns a concise, stable display identity for one parent-session subagent. */
+export declare function subagentDisplayName(sequence: number): string;

package/dist/domain/orchestration/subagent-identity.js

@@ -0,0 +1 @@
+const t=["Atlas","Nova","Orion","Sage","Lyra","Ember","Aster","Coda"];function r(e){const a=Math.max(0,Math.floor(e)),n=t[a%t.length]??"Agent",o=Math.floor(a/t.length)+1;return o===1?n:`${n} ${o}`}export{r as subagentDisplayName};

package/dist/domain/orchestration/subagent.d.ts

@@ -0,0 +1,33 @@
+export type SubagentStatus = 'queued' | 'running' | 'completed' | 'completed_with_warning' | 'failed' | 'cancelled';
+export type SubagentLimitReason = 'iteration' | 'timeout' | 'tokens' | 'tool_calls';
+export type SubagentMode = 'research' | 'worker';
+export interface SubagentHandoff {
+    readonly summary: string;
+    readonly filesInspected: readonly string[];
+    readonly filesChanged: readonly string[];
+    readonly commandsRun: readonly string[];
+    readonly verification: readonly string[];
+    readonly warnings: readonly string[];
+}
+export interface SubagentRequest {
+    readonly task: string;
+    readonly context?: string;
+    readonly model?: string;
+    readonly mode?: SubagentMode;
+    readonly background?: boolean;
+    readonly writeScope?: readonly string[];
+}
+export interface SubagentResult {
+    readonly id: string;
+    readonly displayName: string;
+    readonly task: string;
+    readonly status: SubagentStatus;
+    readonly mode: SubagentMode;
+    readonly model: string;
+    readonly summary: string;
+    readonly handoff: SubagentHandoff;
+    readonly toolsUsed: readonly string[];
+    readonly estimatedTokens?: number;
+    readonly limitReason?: SubagentLimitReason;
+    readonly durationMs: number;
+}

package/dist/domain/orchestration/work-plan.d.ts

@@ -0,0 +1,77 @@
+export declare const MAX_WORK_PLAN_STEPS = 10;
+export type WorkItemStatus = 'queued' | 'active' | 'completed' | 'failed' | 'blocked';
+export type WorkPlanStatus = 'active' | 'completed' | 'failed' | 'blocked';
+export type WorkEvidenceKind = 'read' | 'diff' | 'test' | 'typecheck' | 'lint' | 'build' | 'runtime';
+export interface WorkItem {
+    id: string;
+    title: string;
+    description: string;
+    dependencies: readonly string[];
+    status: WorkItemStatus;
+    assignedAgent?: string;
+}
+export interface WorkPlanStep extends WorkItem {
+    index: number;
+    scope: readonly string[];
+    acceptanceCriteria: readonly string[];
+    verificationHints: readonly string[];
+    evidenceIds: readonly string[];
+}
+export interface WorkPlan {
+    id: string;
+    turnId: string;
+    goal: string;
+    language: string;
+    version: number;
+    status: WorkPlanStatus;
+    steps: readonly WorkPlanStep[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface WorkEvidence {
+    id: string;
+    turnId: string;
+    planId: string;
+    stepId: string;
+    kind: WorkEvidenceKind;
+    summary: string;
+    status: 'passed' | 'failed' | 'informational';
+    command?: string;
+    paths?: readonly string[];
+    exitCode?: number;
+    createdAt: string;
+}
+export interface SchedulerLimits {
+    maxConcurrency: number;
+    maxTasks: number;
+    maxDurationMs: number;
+    maxTokens?: number;
+}
+export interface WorkPlanUpdateInput {
+    action: 'create' | 'replace' | 'step_status' | 'record_evidence' | 'complete' | 'fail' | 'block';
+    goal?: string;
+    language?: string;
+    steps?: readonly WorkPlanStepInput[];
+    stepId?: string;
+    status?: Exclude<WorkItemStatus, 'queued'>;
+    evidence?: WorkEvidenceInput;
+    reason?: string;
+}
+export interface WorkPlanStepInput {
+    id: string;
+    title: string;
+    description: string;
+    dependencies?: readonly string[];
+    scope?: readonly string[];
+    acceptanceCriteria: readonly string[];
+    verificationHints?: readonly string[];
+}
+export interface WorkEvidenceInput {
+    stepId: string;
+    kind: WorkEvidenceKind;
+    summary: string;
+    status: WorkEvidence['status'];
+    command?: string;
+    paths?: readonly string[];
+    exitCode?: number;
+}

package/dist/domain/orchestration/work-plan.js

@@ -0,0 +1 @@
+const _=10;export{_ as MAX_WORK_PLAN_STEPS};

package/dist/domain/project/project-identity.d.ts

@@ -0,0 +1,6 @@
+export interface ProjectIdentity {
+    canonicalPath: string;
+    gitRoot?: string;
+    fingerprint: string;
+}
+export declare function createProjectFingerprint(canonicalPath: string, gitRoot?: string): string;

package/dist/domain/project/project-identity.js

@@ -0,0 +1 @@
+import r from"node:crypto";function a(t,e){return r.createHash("sha256").update(`${t}\0${e??""}`,"utf8").digest("hex")}export{a as createProjectFingerprint};

package/dist/domain/runtime/assistant-delta-normalizer.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Repairs an SSE frame prefix only when a compatibility gateway attaches it
+ * directly to preceding assistant text. Prefixes after whitespace or at the
+ * beginning of a new line are preserved because they can be intentional text
+ * or code.
+ */
+export declare class AssistantDeltaNormalizer {
+    private previousCharacter;
+    normalize(content: string): string;
+    private isAttachedToAssistantText;
+}

package/dist/domain/runtime/assistant-delta-normalizer.js

@@ -0,0 +1 @@
+class n{previousCharacter;normalize(s){const t=s.replace(/data:\s+/gu,(e,a,r)=>this.isAttachedToAssistantText(r,a)?"":e);return t.length>0&&(this.previousCharacter=t.at(-1)),t}isAttachedToAssistantText(s,t){const e=t===0?this.previousCharacter:s.at(t-1);return e!==void 0&&!/\s/.test(e)}}export{n as AssistantDeltaNormalizer};

package/dist/domain/runtime/resource-limits.d.ts

@@ -0,0 +1,75 @@
+/** Centralized defensive limits for untrusted local, extension, and protocol data. */
+export declare const RESOURCE_LIMITS: {
+    readonly processTerminationGraceMs: 500;
+    readonly processTerminationTimeoutMs: 2000;
+    readonly configFileBytes: number;
+    readonly workspaceSettingsBytes: number;
+    readonly mcpConfigBytes: number;
+    readonly sessionBundleBytes: number;
+    readonly sessionJournalBytes: number;
+    readonly sessionEvents: 100000;
+    readonly sessionTranscriptEntries: 50000;
+    readonly sessionAttachments: 32;
+    readonly sessionAttachmentTotalBytes: number;
+    readonly sessionTextBytes: number;
+    readonly memoryJournalBytes: number;
+    readonly memoryIndexBytes: number;
+    readonly memoryBundleBytes: number;
+    readonly memoryRecords: 2000;
+    readonly memoryStatementBytes: number;
+    readonly memoryRationaleBytes: number;
+    readonly memoryTopics: 16;
+    readonly memoryTopicBytes: 256;
+    readonly memorySupersedes: 16;
+    readonly memoryEvidenceReferences: 32;
+    readonly memoryEvidenceReferenceBytes: 512;
+    readonly memoryContextRecords: 12;
+    readonly jsonlLineBytes: number;
+    readonly desktopAttachmentChunkBytes: number;
+    readonly jsonlIdBytes: 256;
+    readonly jsonlPathBytes: 4096;
+    readonly jsonlPromptBytes: number;
+    readonly pendingAttachments: 16;
+    readonly pendingAttachmentTotalBytes: number;
+    readonly maxAttachmentBytes: number;
+    readonly clipboardTextBytes: number;
+    readonly clipboardTimeoutMs: 15000;
+    readonly instructionFileBytes: number;
+    readonly instructionTotalBytes: number;
+    readonly instructionFiles: 32;
+    readonly skillDocumentBytes: number;
+    readonly pluginManifestBytes: number;
+    readonly subagentTaskBytes: number;
+    readonly subagentContextBytes: number;
+    readonly subagentMaxWriteScopeItems: 32;
+    readonly subagentWriteScopeItemBytes: 512;
+    readonly subagentSummaryBytes: number;
+    readonly subagentMaxDurationMs: 1800000;
+    readonly subagentMaxTokens: 200000;
+    readonly subagentMaxConcurrent: 4;
+    readonly subagentMaxRetainedJobs: 32;
+    readonly subagentMaxIterations: 200;
+    readonly subagentMaxToolCallsPerTurn: 100;
+    readonly agentMaxIterations: 500;
+    readonly agentMaxToolCallsPerTurn: 1;
+    readonly subagentToolArgumentBytes: number;
+    readonly subagentToolResultBytes: number;
+    readonly goalObjectiveBytes: number;
+    readonly goalReasonBytes: number;
+    readonly goalEvidenceItems: 8;
+    readonly goalEvidenceBytes: number;
+    readonly goalDefaultMaxTurns: 100;
+    readonly goalMaximumMaxTurns: 10000;
+    readonly goalMaximumTokenBudget: 10000000;
+    readonly goalDefaultMaxDurationMs: number;
+    readonly goalMaximumMaxDurationMs: number;
+    readonly goalDefaultMaxEvaluatorRuns: 100;
+    readonly tuiTranscriptMessages: 2000;
+    readonly jsonlMaxInFlight: 4;
+    readonly workspaceReferenceCount: 32;
+    readonly workspaceReferenceInstructionBytes: number;
+    readonly logQueueEntries: 10000;
+    readonly logQueueBytes: number;
+    readonly internalProcessTimeoutMs: number;
+    readonly internalProcessOutputBytes: number;
+};

package/dist/domain/runtime/resource-limits.js

@@ -0,0 +1 @@
+const e={processTerminationGraceMs:500,processTerminationTimeoutMs:2e3,configFileBytes:262144,workspaceSettingsBytes:262144,mcpConfigBytes:524288,sessionBundleBytes:20971520,sessionJournalBytes:20971520,sessionEvents:1e5,sessionTranscriptEntries:5e4,sessionAttachments:32,sessionAttachmentTotalBytes:52428800,sessionTextBytes:524288,memoryJournalBytes:8388608,memoryIndexBytes:8388608,memoryBundleBytes:8388608,memoryRecords:2e3,memoryStatementBytes:4096,memoryRationaleBytes:2048,memoryTopics:16,memoryTopicBytes:256,memorySupersedes:16,memoryEvidenceReferences:32,memoryEvidenceReferenceBytes:512,memoryContextRecords:12,jsonlLineBytes:1048576,desktopAttachmentChunkBytes:524288,jsonlIdBytes:256,jsonlPathBytes:4096,jsonlPromptBytes:524288,pendingAttachments:16,pendingAttachmentTotalBytes:52428800,maxAttachmentBytes:10485760,clipboardTextBytes:10485760,clipboardTimeoutMs:15e3,instructionFileBytes:131072,instructionTotalBytes:262144,instructionFiles:32,skillDocumentBytes:524288,pluginManifestBytes:262144,subagentTaskBytes:16384,subagentContextBytes:16384,subagentMaxWriteScopeItems:32,subagentWriteScopeItemBytes:512,subagentSummaryBytes:24576,subagentMaxDurationMs:18e5,subagentMaxTokens:2e5,subagentMaxConcurrent:4,subagentMaxRetainedJobs:32,subagentMaxIterations:200,subagentMaxToolCallsPerTurn:100,agentMaxIterations:500,agentMaxToolCallsPerTurn:1,subagentToolArgumentBytes:65536,subagentToolResultBytes:262144,goalObjectiveBytes:16384,goalReasonBytes:2048,goalEvidenceItems:8,goalEvidenceBytes:4096,goalDefaultMaxTurns:100,goalMaximumMaxTurns:1e4,goalMaximumTokenBudget:1e7,goalDefaultMaxDurationMs:72e5,goalMaximumMaxDurationMs:288e5,goalDefaultMaxEvaluatorRuns:100,tuiTranscriptMessages:2e3,jsonlMaxInFlight:4,workspaceReferenceCount:32,workspaceReferenceInstructionBytes:16384,logQueueEntries:1e4,logQueueBytes:4194304,internalProcessTimeoutMs:12e4,internalProcessOutputBytes:4194304};export{e as RESOURCE_LIMITS};

package/dist/domain/session/attachment.d.ts

@@ -0,0 +1,13 @@
+export type AttachmentSource = 'clipboard' | 'file';
+export interface Attachment {
+    id: string;
+    name: string;
+    mimeType: string;
+    sizeBytes: number;
+    source: AttachmentSource;
+    storagePath?: string;
+}
+export interface AttachmentPayload {
+    attachment: Attachment;
+    bytes: Uint8Array;
+}

package/dist/domain/session/session-schema.d.ts

@@ -0,0 +1,6 @@
+import type { SessionEvent, SessionMetadata, TranscriptEntry } from './session.js';
+/** Runtime validators for session data persisted in JSON files and journals. */
+export declare function isSessionMetadata(value: unknown): value is SessionMetadata;
+export declare function isSessionEvent(value: unknown): value is SessionEvent;
+export declare function isTranscriptEntry(value: unknown): value is TranscriptEntry;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;

package/dist/domain/session/session-schema.js

@@ -0,0 +1 @@
+function s(t){return n(t)?typeof t.id=="string"&&typeof t.projectFingerprint=="string"&&typeof t.cwd=="string"&&(typeof t.model=="string"||t.model===null)&&(typeof t.profile=="string"||t.profile===null)&&(t.status==="active"||t.status==="completed"||t.status==="failed"||t.status==="cancelled")&&typeof t.createdAt=="string"&&typeof t.updatedAt=="string"&&(t.name===void 0||typeof t.name=="string"):!1}function i(t){return n(t)?typeof t.type=="string"&&typeof t.timestamp=="string"&&typeof t.sessionId=="string"&&(t.runId===void 0||typeof t.runId=="string")&&(t.turnId===void 0||typeof t.turnId=="string")&&(t.data===void 0||n(t.data)):!1}function e(t){return!n(t)||typeof t.timestamp!="string"||typeof t.content!="string"||t.type!=="user"&&t.type!=="assistant"&&t.type!=="system"&&t.type!=="tool"?!1:(t.turnId===void 0||typeof t.turnId=="string")&&(t.attachmentIds===void 0||Array.isArray(t.attachmentIds)&&t.attachmentIds.every(r=>typeof r=="string"))}function n(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}export{n as isRecord,i as isSessionEvent,s as isSessionMetadata,e as isTranscriptEntry};

package/dist/domain/session/session.d.ts

@@ -0,0 +1,27 @@
+export type SessionStatus = 'active' | 'completed' | 'failed' | 'cancelled';
+export interface SessionMetadata {
+    id: string;
+    name?: string;
+    projectFingerprint: string;
+    cwd: string;
+    model: string | null;
+    profile: string | null;
+    status: SessionStatus;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SessionEvent {
+    type: string;
+    timestamp: string;
+    sessionId: string;
+    runId?: string;
+    turnId?: string;
+    data?: Record<string, unknown>;
+}
+export interface TranscriptEntry {
+    type: 'user' | 'assistant' | 'system' | 'tool';
+    timestamp: string;
+    content: string;
+    turnId?: string;
+    attachmentIds?: readonly string[];
+}

package/dist/domain/settings/settings-document.d.ts

@@ -0,0 +1,8 @@
+import { type CliConfig } from '../config/config-schema.js';
+import { type WorkspacePermissionPolicy } from '../workspace/workspace-settings.js';
+export interface ValidatedSettingsDocument {
+    readonly config: Partial<CliConfig>;
+    readonly permissions?: WorkspacePermissionPolicy;
+}
+export declare function validateSettingsDocument(value: unknown): ValidatedSettingsDocument;
+export declare function permissionsFromSettings(document: ValidatedSettingsDocument): WorkspacePermissionPolicy;

package/dist/domain/settings/settings-document.js

@@ -0,0 +1 @@
+import{CliError as m}from"../errors/cli-error.js";import{CLI_ERROR_CODES as f}from"../errors/error-codes.js";import{CONFIG_SCHEMA_VERSION as p,CONFIGURABLE_KEYS as t,validateConfig as d}from"../config/config-schema.js";import{DEFAULT_WORKSPACE_SETTINGS as S,validateWorkspaceSettings as g}from"../workspace/workspace-settings.js";import{findUnexpectedRecordKey as E,isRecord as a}from"../validation/record-schema.js";const u=["schemaVersion",...t,"permissions"];function R(i){if(!a(i))throw r("Settings must be a JSON object.");const e=E(i,u);if(e!==void 0)throw r(`Unsupported settings field: \`${e}\`.`);const n={};for(const s of["schemaVersion",...t])i[s]!==void 0&&(n[s]=i[s]);const o=d(n);if(i.permissions===void 0)return{config:o};const c=g({schemaVersion:i.schemaVersion??p,permissions:i.permissions});return{config:o,permissions:c.permissions}}function V(i){return i.permissions??S.permissions}function r(i){return new m(f.CONFIG_SCHEMA_INVALID,i,{category:"config",userMessage:`Invalid settings: ${i}`})}export{V as permissionsFromSettings,R as validateSettingsDocument};

package/dist/domain/validation/record-schema.d.ts

@@ -0,0 +1,4 @@
+/** Narrows JSON-shaped values before schema-specific validation. */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/** Returns the first unsupported own property in a configuration object. */
+export declare function findUnexpectedRecordKey(value: Record<string, unknown>, allowedKeys: readonly string[]): string | undefined;

package/dist/domain/validation/record-schema.js

@@ -0,0 +1 @@
+function o(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function c(e,n){const r=new Set(n);return Object.keys(e).find(t=>!r.has(t))}export{c as findUnexpectedRecordKey,o as isRecord};

package/dist/domain/workspace/workspace-settings.d.ts

@@ -0,0 +1,12 @@
+export declare const WORKSPACE_SETTINGS_SCHEMA_VERSION = 1;
+export interface WorkspacePermissionPolicy {
+    readonly allow: readonly string[];
+    readonly ask: readonly string[];
+    readonly deny: readonly string[];
+}
+export interface WorkspaceSettings {
+    readonly schemaVersion: 1;
+    readonly permissions: WorkspacePermissionPolicy;
+}
+export declare const DEFAULT_WORKSPACE_SETTINGS: WorkspaceSettings;
+export declare function validateWorkspaceSettings(value: unknown): WorkspaceSettings;

package/dist/domain/workspace/workspace-settings.js

@@ -0,0 +1 @@
+import{CliError as a}from"../errors/cli-error.js";import{CLI_ERROR_CODES as m}from"../errors/error-codes.js";import{findUnexpectedRecordKey as d,isRecord as p}from"../validation/record-schema.js";const o=1,f={schemaVersion:o,permissions:{allow:[],ask:[],deny:[]}};function g(s){if(!p(s))throw r("Workspace settings must be a JSON object.");if(c(s,["schemaVersion","permissions"],"workspace settings"),s.schemaVersion!==void 0&&s.schemaVersion!==o)throw r("Unsupported workspace settings schema version.");const n=s.permissions===void 0?f.permissions:w(s.permissions);return{schemaVersion:o,permissions:n}}function w(s){if(!p(s))throw r("Workspace permissions must be a JSON object.");return c(s,["allow","ask","deny"],"workspace permissions"),{allow:i(s.allow,"permissions.allow"),ask:i(s.ask,"permissions.ask"),deny:i(s.deny,"permissions.deny")}}function i(s,n){if(s===void 0)return[];if(!Array.isArray(s)||s.some(e=>typeof e!="string"||e.trim().length===0||e.length>256))throw r(`${n} must be an array of non-empty strings (max 256 characters each).`);return[...new Set(s.map(e=>e.trim()))]}function r(s){return new a(m.CONFIG_SCHEMA_INVALID,s,{category:"config",userMessage:`Invalid workspace settings: ${s}`})}function c(s,n,e){const t=d(s,n);if(t!==void 0)throw r(`Unsupported ${e} field: \`${t}\`.`)}export{f as DEFAULT_WORKSPACE_SETTINGS,o as WORKSPACE_SETTINGS_SCHEMA_VERSION,g as validateWorkspaceSettings};

package/dist/infrastructure/agent-sdk/agent-instance-factory.d.ts

@@ -0,0 +1,22 @@
+import { LotaGateAgent, type LotaGateAgentOptions, type ToolAuthorizationRule, type ToolAuthorizationEvent } from '@lotagate/agent-sdk';
+import { type ToolExecutor } from '@lotagate/agent-sdk';
+import type { LotaGate } from '@lotagate/sdk';
+import type { ModelCallSummary } from '../../ports/model-diagnostics.js';
+import type { HostPlatformContext } from '../platform/host-platform.js';
+export interface AgentInstanceOptions extends Omit<LotaGateAgentOptions, 'modelClient'> {
+    client: LotaGate;
+    onModelComplete?: (summary: ModelCallSummary) => void;
+}
+export declare function createAgentInstance(options: AgentInstanceOptions): LotaGateAgent;
+export interface LocalAgentInstanceOptions extends Omit<AgentInstanceOptions, 'toolExecutor'> {
+    platform?: HostPlatformContext;
+    toolExecutors?: readonly ToolExecutor[];
+    allowedTools?: readonly string[];
+    deniedTools?: readonly string[];
+    requireApproval?: boolean;
+    approvalHandler?: NonNullable<LotaGateAgentOptions['toolPolicy']>['approvalHandler'];
+    authorizationRules?: readonly ToolAuthorizationRule[];
+    authorizationObserver?: (event: ToolAuthorizationEvent) => void | Promise<void>;
+    onModelComplete?: (summary: ModelCallSummary) => void;
+}
+export declare function createLocalAgentInstance(options: LocalAgentInstanceOptions): LotaGateAgent;

package/dist/infrastructure/agent-sdk/agent-instance-factory.js

@@ -0,0 +1 @@
+import{LotaGateAgent as f}from"@lotagate/agent-sdk";import{CompositeToolExecutor as m}from"@lotagate/agent-sdk";import{LocalFilesystemToolExecutor as s}from"../filesystem/local-filesystem-tool-executor.js";import{ShellToolExecutor as x}from"../shell/shell-tool-executor.js";import{createToolCallingModelClient as C}from"./tool-calling-model-client.js";function g(n){const{client:t,onModelComplete:e,...o}=n;return new f({...o,modelClient:C(t,e===void 0?{}:{onComplete:e})})}function v(n){const{toolExecutors:t,platform:e,allowedTools:o,deniedTools:l,requireApproval:r,approvalHandler:i,authorizationRules:d,authorizationObserver:a,onModelComplete:u,...c}=n,p=new m([...t??[new s,new x({...e===void 0?{}:{platform:e}})]]);return g({...c,...u===void 0?{}:{onModelComplete:u},toolExecutor:p,toolPolicy:{...o===void 0?{}:{allowedTools:o},...l===void 0?{}:{deniedTools:l},...r===void 0?{}:{requireApproval:r},...i===void 0?{}:{approvalHandler:i},...d===void 0?{}:{authorizationRules:d},...a===void 0?{}:{authorizationObserver:a}}})}export{g as createAgentInstance,v as createLocalAgentInstance};

package/dist/infrastructure/agent-sdk/model-tool-name-mapper.d.ts

@@ -0,0 +1,13 @@
+import type { ChatCompletionChunk, ChatCompletionRequest, ChatCompletionResponse, ToolDefinition } from '@lotagate/sdk';
+export interface ModelToolNameMap {
+    toProviderName(name: string): string;
+    toInternalName(name: string): string;
+}
+/**
+ * Creates a stable, provider-safe alias map while keeping the CLI's canonical
+ * names available to executors, policies, and UI events.
+ */
+export declare function createModelToolNameMap(tools: readonly ToolDefinition[] | undefined): ModelToolNameMap;
+export declare function mapRequestToolNames<T extends ChatCompletionRequest>(request: T, nameMap: ModelToolNameMap): T;
+export declare function mapResponseToolNames(response: ChatCompletionResponse, nameMap: ModelToolNameMap): ChatCompletionResponse;
+export declare function mapChunkToolNames(chunk: ChatCompletionChunk, nameMap: ModelToolNameMap): ChatCompletionChunk;

package/dist/infrastructure/agent-sdk/model-tool-name-mapper.js

@@ -0,0 +1 @@
+const u=/^[A-Za-z0-9_-]+$/u,c=64;function _(n){const t=new Map,e=new Map;for(const o of[...new Set((n??[]).flatMap(d))]){const i=l(o),a=e.get(i);if(a!==void 0&&a!==o)throw new Error(`Tool names "${a}" and "${o}" normalize to the same provider name "${i}".`);t.set(o,i),e.set(i,o)}return{toProviderName:o=>t.get(o)??l(o),toInternalName:o=>e.get(o)??o}}function g(n,t){const e={...n,messages:n.messages.map(o=>!("tool_calls"in o)||o.tool_calls===void 0?o:{...o,tool_calls:o.tool_calls.map(i=>r(i,t.toProviderName))}),...n.tools===void 0?{}:{tools:n.tools.map(o=>m(o,t.toProviderName))}};return n.tool_choice!==void 0&&(e.tool_choice=f(n.tool_choice,t.toProviderName)),n.toolChoice!==void 0&&(e.toolChoice=f(n.toolChoice,t.toProviderName)),n.toolConfig!==void 0&&(e.toolConfig=f(n.toolConfig,t.toProviderName)),e}function p(n,t){return{...n,choices:n.choices.map(e=>({...e,message:e.message.tool_calls===void 0?e.message:{...e.message,tool_calls:e.message.tool_calls.map(o=>r(o,t.toInternalName))}}))}}function N(n,t){return{...n,choices:n.choices.map(e=>({...e,delta:e.delta.tool_calls===void 0?e.delta:{...e.delta,tool_calls:e.delta.tool_calls.map(o=>r(o,t.toInternalName))}}))}}function l(n){const t=n.replace(/[^A-Za-z0-9_-]+/gu,"_");if(t.length<=64&&u.test(t))return t;const e=s(n).slice(0,8);return`${t.slice(0,64-e.length-1)}_${e}`}function s(n){let t=2166136261;for(const e of n)t^=e.codePointAt(0)??0,t=Math.imul(t,16777619);return(t>>>0).toString(16).padStart(8,"0")}function m(n,t){return"function"in n&&n.function!==void 0?{...n,function:{...n.function,name:t(n.function.name)}}:"functionDeclarations"in n?{...n,functionDeclarations:n.functionDeclarations.map(e=>({...e,name:t(e.name)}))}:"name"in n?{...n,name:t(n.name)}:n}function r(n,t){return{...n,function:{...n.function,name:t(n.function.name)}}}function f(n,t){return typeof n=="string"?n:"function"in n&&n.function!==void 0?{...n,function:{...n.function,name:t(n.function.name)}}:"name"in n&&typeof n.name=="string"?{...n,name:t(n.name)}:"functionCallingConfig"in n&&n.functionCallingConfig.allowedFunctionNames!==void 0?{...n,functionCallingConfig:{...n.functionCallingConfig,allowedFunctionNames:n.functionCallingConfig.allowedFunctionNames.map(t)}}:n}function d(n){return"function"in n&&n.function!==void 0?[n.function.name]:"name"in n&&typeof n.name=="string"?[n.name]:"functionDeclarations"in n?n.functionDeclarations.map(t=>t.name):[]}export{_ as createModelToolNameMap,N as mapChunkToolNames,g as mapRequestToolNames,p as mapResponseToolNames};

package/dist/infrastructure/agent-sdk/tool-calling-completion-client.d.ts

@@ -0,0 +1,4 @@
+import type { LotaGate } from '@lotagate/sdk';
+import type { ModelCompletionClient } from '../../ports/model-completion-client.js';
+/** Reuses the agent model boundary for non-streaming host-owned completions. */
+export declare function createToolCallingCompletionClient(client: LotaGate): ModelCompletionClient;

package/dist/infrastructure/agent-sdk/tool-calling-completion-client.js

@@ -0,0 +1 @@
+import{createToolCallingModelClient as l}from"./tool-calling-model-client.js";function i(e){const n=l(e);return{chat:{completions:{create:async(o,r)=>{const t=await n.chat.completions.create({...o,stream:!1},r);if(a(t))throw new Error("The completion adapter returned a streaming response unexpectedly.");return t}}}}}function a(e){return typeof e=="object"&&e!==null&&Symbol.asyncIterator in e}export{i as createToolCallingCompletionClient};

package/dist/infrastructure/agent-sdk/tool-calling-model-client.d.ts

@@ -0,0 +1,11 @@
+import { type LotaGate } from '@lotagate/sdk';
+import type { LotaGateAgentOptions } from '@lotagate/agent-sdk';
+import type { ModelCallObserver } from '../../ports/model-diagnostics.js';
+type AgentModelClient = LotaGateAgentOptions['modelClient'];
+/**
+ * Adapts the published SDK client to the Agent SDK model port and makes the
+ * intended tool-calling mode explicit for gateways that do not infer it from
+ * the presence of `tools` alone.
+ */
+export declare function createToolCallingModelClient(client: LotaGate, diagnostics?: ModelCallObserver): AgentModelClient;
+export {};

package/dist/infrastructure/agent-sdk/tool-calling-model-client.js

@@ -0,0 +1 @@
+import"@lotagate/sdk";import{AssistantDeltaNormalizer as q}from"../../domain/runtime/assistant-delta-normalizer.js";import{createModelToolNameMap as nn,mapChunkToolNames as tn,mapRequestToolNames as U,mapResponseToolNames as z}from"./model-tool-name-mapper.js";import{isRetryableModelResponseError as en,MODEL_RESPONSE_MAX_RETRIES as on,retryModelStream as rn}from"../../application/model/model-response-retry.js";const W=on;function kn(n,t={}){return{chat:{completions:{create:((e,s)=>{const r=nn(e.tools),i=e.tools!==void 0&&e.tools.length>0?1:void 0;if(e.stream===!0){const l=U(v({...e,stream:!0}),r),f=cn(e)?ln(n,l,s,i):rn({create:async()=>await n.chat.completions.create(l,s),isObservable:un,...s?.signal===void 0?{}:{signal:s.signal}});return an(n,l,e.tools,s,f,e.model,t,r,i)}const a=U(v({...e,stream:!1}),r);return sn(n.chat.completions.create(a,s),e.model,t,r,i)})}}}}async function sn(n,t,o,e,s){const r=O(z(w(await n),e),s),i=r.choices[0]?.message;return o.onComplete?.({model:t,stream:!1,contentLength:$(i?.content),toolCallCount:i?.tool_calls?.length??0,toolNames:(i?.tool_calls??[]).map(a=>a.function.name),...r.usage===void 0?{}:{usage:k(r.usage)},...r.choices[0]?.finish_reason===void 0?{}:{finishReason:r.choices[0].finish_reason}}),r}async function*an(n,t,o,e,s,r,i,a,l){let f=0,c;const d=new Set,m=new Set,_=new dn(o);let S=!1,b,x,M=!1;const Z=new q;try{for await(const C of s){const h=tn(fn(C,Z),a),p=_.consume(h).chunk,y=p.choices[0];p.usage!==void 0&&(b=k(p.usage));const I=$(y?.delta.content);if(f+=I,c=y?.finish_reason??c,I>0&&(S=!0),y?.finish_reason==="tool_calls"&&!M){const J=_.flush(p);if(!S&&B(J)){const R=z(w(await N(n,t,e,l)),a);R.usage!==void 0&&(b=k(R.usage)),G(R,m,d),c=R.choices[0]?.finish_reason??c,yield T(R);return}const L=P(J,l);K(L,m,d),M=!0,yield p,yield L}else yield p;x=p}if(!M&&x!==void 0&&_.hasCalls()){const C=_.flush(x);if(!S&&B(C)){const g=z(w(await N(n,t,e,l)),a);g.usage!==void 0&&(b=k(g.usage)),G(g,m,d),c=g.choices[0]?.finish_reason??c,yield T(g);return}const h=P(C,l);K(h,m,d),M=!0,yield h}}catch(C){if(!S&&!M&&Y(C)&&e?.signal?.aborted!==!0){const h=z(w(await N(n,t,e,l)),a);h.usage!==void 0&&(b=k(h.usage));const g=h.choices[0]?.message,p=$(g?.content);f+=p;for(const y of g?.tool_calls??[])y.id.length>0&&m.add(y.id),y.function.name.length>0&&d.add(y.function.name);c=h.choices[0]?.finish_reason??c,yield T(h);return}throw C}finally{i.onComplete?.({model:r,stream:!0,contentLength:f,toolCallCount:m.size||d.size,toolNames:[...d],...c===void 0?{}:{finishReason:c},...b===void 0?{}:{usage:b}})}}async function N(n,t,o,e){const s=v({...t,stream:!1});for(let r=0;;r+=1)try{const i=w(await n.chat.completions.create(s,o));if(r<W&&B(i))continue;return O(i,e)}catch(i){if(r>=W||!Y(i)||o?.signal?.aborted===!0)throw i}}async function*ln(n,t,o,e){yield T(await N(n,t,o,e))}function v(n){return n.tools===void 0||n.tools.length===0?n:{...n,tool_choice:"auto"}}function cn(n){const t=n.messages.at(-1);return t!==void 0&&"role"in t&&t.role==="tool"}function un(n){return n.choices.some(t=>{const o=t.delta.content,e=t.delta.tool_calls,s=t.delta;return typeof o=="string"&&o.length>0||Array.isArray(o)&&o.length>0||Array.isArray(e)&&e.length>0||u(s.function_call)})}function O(n,t){return t===void 0?n:{...n,choices:n.choices.map(o=>{const e=o.message.tool_calls;return e===void 0||e.length<=t?o:{...o,message:{...o.message,tool_calls:e.slice(0,t)}}})}}function P(n,t){return t===void 0?n:{...n,choices:n.choices.map(o=>{const e=o.delta.tool_calls;return e===void 0||e.length<=t?o:{...o,delta:{...o.delta,tool_calls:e.slice(0,t)}}})}}function T(n){const t=w(n),o=t.choices[0],e=o?.message;return{id:t.id,object:"chat.completion.chunk",created:t.created,model:t.model,choices:[{index:o?.index??0,delta:{role:"assistant",content:F(e?.content),...e?.tool_calls===void 0?{}:{tool_calls:e.tool_calls.map((s,r)=>({...s,index:r}))}},...o?.finish_reason===void 0?{}:{finish_reason:o.finish_reason}}],...t.usage===void 0?{}:{usage:t.usage}}}function fn(n,t){return{...n,choices:n.choices.map(o=>{const e=o.delta.content,r=Array.isArray(e)?t.normalize(F(e)):typeof e=="string"?t.normalize(e):e,i=o.delta,a=[...Array.isArray(e)?H(e):[],...Q(i.function_call,0)];return r===e&&a.length===0?o:{...o,delta:{...o.delta,...r===e?{}:{content:r},...a.length===0?{}:{tool_calls:[...o.delta.tool_calls??[],...a]}}}})}}class dn{knownNames;calls=new Map;order=[];keysByPosition=new Map;constructor(t){this.knownNames=new Set((t??[]).flatMap(o=>Cn(o)))}consume(t){let o=!1;const e=t.choices.map(s=>{const r=s.delta.tool_calls;if(r===void 0||r.length===0)return s;o=!0,r.forEach((a,l)=>{u(a)&&this.append(a,l)});const i={...s.delta};return delete i.tool_calls,{...s,delta:i}});return{chunk:{...t,choices:e},hadToolCalls:o}}hasCalls(){return this.order.length>0}flush(t){const o=this.order.map((i,a)=>{const l=this.calls.get(i);return{id:l.id||`tool-call-${a}`,type:l.type,function:{name:l.name,arguments:l.arguments},...l.providerMetadata===void 0?{}:{provider_metadata:l.providerMetadata}}}),e=new Set,s=o.filter(i=>{const a=`${i.function.name}\0${i.function.arguments}`;return e.has(a)?!1:(e.add(a),!0)}),r=t.choices.map((i,a)=>a===0?{...i,delta:{...i.delta,tool_calls:s}}:i);return{...t,choices:r}}append(t,o){const e=E(t),s=gn(t),r=j(t),i=X(t),a=A(t),l=hn(t,o),f=this.keysByPosition.get(l)??mn(e,l);this.keysByPosition.set(l,f);const c=this.calls.get(f),d=pn(c?.name??"",r,this.knownNames),m=yn(c?.arguments??"",i);if(c===void 0){this.calls.set(f,{id:e,type:s,name:d,arguments:m,...a===void 0?{}:{providerMetadata:a}}),this.order.push(f);return}const _=c.providerMetadata??a;this.calls.set(f,{id:c.id.length===0&&e.length>0?e:c.id,type:s||c.type,name:c.name+d,arguments:m,..._===void 0?{}:{providerMetadata:_}})}}function A(n){if(!u(n))return;const t=n.provider_metadata??n.providerMetadata;if(u(t))return t;const o=n.thoughtSignature??n.thought_signature;return typeof o=="string"&&o.length>0?{google:{thought_signature:o}}:void 0}function hn(n,t){const o=n.index;return typeof o=="number"&&Number.isInteger(o)?o:t}function mn(n,t){return n.length>0?`id:${n}`:`index:${t}`}function E(n){const t=n;return u(t)&&typeof t.id=="string"?t.id:""}function gn(n){const t=n;return u(t)&&typeof t.type=="string"&&t.type.length>0?t.type:"function"}function j(n){const t=n;return u(t)&&u(t.function)&&typeof t.function.name=="string"?t.function.name:""}function X(n){const t=n;return u(t)&&u(t.function)&&typeof t.function.arguments=="string"?t.function.arguments:""}function pn(n,t,o){return t.length===0||t===n?"":o!==void 0&&o.has(t)&&t.startsWith(n)||t.startsWith(n)&&n.length>0?t.slice(n.length):t}function yn(n,t){if(t.length===0)return n;if(n.length===0||t===n)return n.length===0?t:n;if(t.startsWith(n))return t;const o=_n(n,t);return o!==void 0?o:n+t}function B(n){const t=n.choices[0];return((t!==void 0&&"message"in t?t.message.tool_calls:t?.delta.tool_calls)??[]).some(e=>D(X(e))===void 0)}function _n(n,t){if(n.length===0||t.length===0)return;const o=D(n),e=D(t);if(!(o===void 0||e===void 0))return JSON.stringify({...o,...e})}function D(n){try{const t=JSON.parse(n);return u(t)?t:void 0}catch{return}}function K(n,t,o){for(const e of n.choices[0]?.delta.tool_calls??[]){const s=E(e),r=j(e);s.length>0&&t.add(s),r.length>0&&o.add(r)}}function G(n,t,o){for(const e of n.choices[0]?.message?.tool_calls??[]){const s=E(e),r=j(e);s.length>0&&t.add(s),r.length>0&&o.add(r)}}function Cn(n){return"function"in n&&typeof n.function.name=="string"?[n.function.name]:"name"in n&&typeof n.name=="string"?[n.name]:"functionDeclarations"in n?n.functionDeclarations.flatMap(t=>typeof t.name=="string"?[t.name]:[]):[]}function w(n){return{...n,choices:n.choices.map(t=>({...t,message:An(t.message)}))}}function An(n){const t=n,o=[...Array.isArray(n.content)?H(n.content):[],...Q(t.function_call,0)],e=Array.isArray(n.content)?F(n.content):typeof n.content=="string"?n.content:void 0,s=e??null,r=Array.isArray(n.content)||typeof n.content=="string"&&e!==n.content;return!r&&o.length===0?n:{...n,...r?{content:s}:{},...o.length===0?{}:{tool_calls:[...n.tool_calls??[],...o]}}}function H(n){const t=[];for(const[o,e]of n.entries())if(!(typeof e!="object"||e===null)){if("functionCall"in e&&u(e.functionCall)&&typeof e.functionCall.name=="string"){const s=e.functionCall.args;t.push({id:typeof e.functionCall.id=="string"&&e.functionCall.id.length>0?e.functionCall.id:`provider-call-${o}`,type:"function",function:{name:e.functionCall.name,arguments:V(s)},...A(e)===void 0?{}:{provider_metadata:A(e)}});continue}if("tool_use"in e&&u(e.tool_use)&&typeof e.tool_use.name=="string"){const s=e.tool_use.input;t.push({id:typeof e.tool_use.id=="string"&&e.tool_use.id.length>0?e.tool_use.id:`provider-call-${o}`,type:"function",function:{name:e.tool_use.name,arguments:JSON.stringify(s??{})},...A(e)===void 0?{}:{provider_metadata:A(e)}})}}return t}function Q(n,t){if(!u(n)||typeof n.name!="string")return[];const o=n.arguments;return[{id:typeof n.id=="string"&&n.id.length>0?n.id:`provider-call-${t}`,type:"function",function:{name:n.name,arguments:V(o)},...A(n)===void 0?{}:{provider_metadata:A(n)}}]}function V(n){if(n===void 0)return"";if(typeof n=="string")return n;try{return JSON.stringify(n)}catch{return""}}function u(n){return typeof n=="object"&&n!==null&&!Array.isArray(n)}function Y(n){return en(n)}function F(n){return typeof n=="string"?n:Array.isArray(n)?n.reduce((t,o)=>{if(typeof o!="object"||o===null||!("text"in o))return t;const e=o.text;return t+(typeof e=="string"?e:"")},""):""}function $(n){return typeof n=="string"?n.length:Array.isArray(n)?n.reduce((t,o)=>{if(typeof o!="object"||o===null||!("text"in o))return t;const e=o.text;return t+(typeof e=="string"?e.length:0)},0):0}function k(n){return{...typeof n.prompt_tokens=="number"?{promptTokens:n.prompt_tokens}:{},...typeof n.completion_tokens=="number"?{completionTokens:n.completion_tokens}:{},...typeof n.total_tokens=="number"?{totalTokens:n.total_tokens}:{}}}export{kn as createToolCallingModelClient};

package/dist/infrastructure/cache/cache-policy.d.ts

@@ -0,0 +1,7 @@
+export interface CachePolicy {
+    enabled: boolean;
+    modelCatalogTtlMs: number;
+    maxEntryBytes: number;
+    maxTotalBytes: number;
+}
+export declare function resolveCachePolicy(env?: Readonly<Record<string, string | undefined>>): CachePolicy;

package/dist/infrastructure/cache/cache-policy.js

@@ -0,0 +1 @@
+function n(e=process.env){return{enabled:o(e.LOTAGATE_CACHE_ENABLED,!0),modelCatalogTtlMs:r(e.LOTAGATE_MODEL_CACHE_TTL_SECONDS,300,1,86400)*1e3,maxEntryBytes:r(e.LOTAGATE_CACHE_MAX_ENTRY_BYTES,5*1024*1024,1024,50*1024*1024),maxTotalBytes:r(e.LOTAGATE_CACHE_MAX_BYTES,50*1024*1024,1*1024*1024,500*1024*1024)}}function o(e,t){return e===void 0?t:e.trim().toLowerCase()==="true"?!0:e.trim().toLowerCase()==="false"?!1:t}import{readBoundedEnvironmentInteger as r}from"../config/environment-values.js";export{n as resolveCachePolicy};

package/dist/infrastructure/cache/file-cache-store.d.ts

@@ -0,0 +1,17 @@
+import type { CacheStore, CacheWriteOptions } from '../../ports/cache-store.js';
+import type { CachePolicy } from './cache-policy.js';
+export declare class FileCacheStore implements CacheStore {
+    private readonly root;
+    private readonly policy;
+    private readonly now;
+    private prunePromise;
+    constructor(root: string, policy: CachePolicy, now?: () => number);
+    get<T>(namespace: string, key: string): Promise<T | undefined>;
+    set<T>(namespace: string, key: string, value: T, options: CacheWriteOptions): Promise<void>;
+    delete(namespace: string, key: string): Promise<void>;
+    clear(namespace?: string): Promise<void>;
+    prune(): Promise<void>;
+    private schedulePrune;
+    private namespacePath;
+    private filePath;
+}

package/dist/infrastructure/cache/file-cache-store.js

@@ -0,0 +1,2 @@
+import m from"node:crypto";import p from"node:fs";import a from"node:fs/promises";import c from"node:path";import{atomicWriteFile as y,withFileLock as w}from"../filesystem/atomic-file-store.js";import{isFileNotFound as u}from"../filesystem/fs-errors.js";import{readJsonFileBounded as l}from"../filesystem/bounded-json-reader.js";class v{root;policy;now;prunePromise;constructor(t,i,r=Date.now){this.root=t,this.policy=i,this.now=r;try{p.mkdirSync(t,{recursive:!0,mode:448})}catch{}}async get(t,i){if(!this.policy.enabled)return;const r=this.filePath(t,i);try{const e=await l(r,this.policy.maxEntryBytes);if(e.schemaVersion!==1||e.namespace!==t||e.keyHash!==f(t,i)||typeof e.expiresAt!="string")return;if(Date.parse(e.expiresAt)<=this.now()){await this.delete(t,i);return}return e.value}catch(e){u(e)||await this.delete(t,i).catch(()=>{});return}}async set(t,i,r,e){if(!this.policy.enabled||e.ttlMs<=0)return;const s={schemaVersion:1,namespace:t,keyHash:f(t,i),createdAt:new Date(this.now()).toISOString(),expiresAt:new Date(this.now()+e.ttlMs).toISOString(),value:r},n=`${JSON.stringify(s)}
+`;if(Buffer.byteLength(n,"utf8")>this.policy.maxEntryBytes)return;const h=this.filePath(t,i);await w(h,()=>y(h,n)),this.schedulePrune()}async delete(t,i){await a.rm(this.filePath(t,i),{force:!0})}async clear(t){await a.rm(t===void 0?this.root:this.namespacePath(t),{recursive:!0,force:!0})}async prune(){if(!this.policy.enabled)return;const t=await d(this.root),i=[];for(const e of t)try{const s=await a.stat(e),n=await l(e,this.policy.maxEntryBytes);if(n.schemaVersion!==1||typeof n.expiresAt!="string"||Date.parse(n.expiresAt)<=this.now()){await a.rm(e,{force:!0});continue}i.push({filePath:e,size:s.size,modifiedAt:s.mtimeMs})}catch{await a.rm(e,{force:!0})}let r=i.reduce((e,s)=>e+s.size,0);for(const e of i.sort((s,n)=>s.modifiedAt-n.modifiedAt)){if(r<=this.policy.maxTotalBytes)break;await a.rm(e.filePath,{force:!0}),r-=e.size}}schedulePrune(){this.prunePromise===void 0&&(this.prunePromise=this.prune().catch(()=>{}).finally(()=>{this.prunePromise=void 0}))}namespacePath(t){return c.join(this.root,P(t))}filePath(t,i){return c.join(this.namespacePath(t),`${f(t,i)}.json`)}}function f(o,t){return m.createHash("sha256").update(`${o}\0${t}`).digest("hex")}function P(o){return Buffer.from(o,"utf8").toString("base64url")}async function d(o){try{const t=await a.readdir(o,{withFileTypes:!0}),i=[];for(const r of t){const e=c.join(o,r.name);r.isDirectory()?i.push(...await d(e)):r.isFile()&&r.name.endsWith(".json")&&i.push(e)}return i}catch(t){if(u(t))return[];throw t}}export{v as FileCacheStore};