@yeaft/webchat-agent 1.0.599 → 1.0.601

package/yeaft/person/sqlite-repository.js

@@ -93,6 +93,8 @@ export class SqlitePersonRepository {
   async append(episode, kind, data) { return this.request('append', [episode, kind, data]); }
   async startCall(episode, data) { return this.request('startCall', [episode, data]); }
   async finalizeCall(episode, data) { return this.request('finalizeCall', [episode, data]); }
+  async startCapability(episode, data) { return this.request('startCapability', [episode, data]); }
+  async finalizeCapability(episode, data) { return this.request('finalizeCapability', [episode, data]); }
   async createdCapabilities(episode) { return this.request('createdCapabilities', [episode]); }
   async saveCreatedCapability(episode, input) { return this.request('saveCreatedCapability', [episode, validateCreatedCapability(input)]); }
   async episodeAttachments(episode) { return this.request('episodeAttachments', [episode]); }
@@ -104,7 +106,7 @@ export class SqlitePersonRepository {
   async settings(ownerId, settings) { return this.request('settings', [ownerId, settings]); }
   async list(ownerId, collection, options, filter) { return this.request('list', [ownerId, collection, options, filter]); }
   async snapshot(ownerId) { return this.request('snapshot', [ownerId]); }
-  async inspect(ownerId, options) { return this.request('inspect', [ownerId, options]); }
+  async inspect(ownerId, options, nativeToolIds) { return this.request('inspect', [ownerId, options, nativeToolIds]); }
   async search(ownerId, options) { return this.request('search', [ownerId, options]); }
   /** Ascending durable journal, scoped before paging. Empty pages retain after. */
   async searchChanges(ownerId, options) { return this.request('searchChanges', [ownerId, options]); }

package/yeaft/person/sqlite-store.js

@@ -49,7 +49,7 @@ const publicOutput = (output, failed) => {
     : { text: output.text, bytes: retainedBytes, complete: true, usage, stopReason };
 };
 const READS = new Set(['receipt', 'inspect', 'search', 'getPerson', 'context', 'recall', 'list', 'searchChanges', 'resolveMemories', 'createdCapabilities', 'episodeAttachments']);
-const WRITES = new Set(['open', 'recover', 'admit', 'heartbeat', 'append', 'startCall', 'finalizeCall', 'commit', 'finish', 'cancel', 'settings', 'snapshot', 'saveCreatedCapability']);
+const WRITES = new Set(['open', 'recover', 'admit', 'heartbeat', 'append', 'startCall', 'finalizeCall', 'startCapability', 'finalizeCapability', 'commit', 'finish', 'cancel', 'settings', 'snapshot', 'saveCreatedCapability']);
 const memoryKind = kind => { if (!['messages', 'concepts'].includes(kind)) fail('INVALID_REQUEST'); return kind; };
 const boundedLimit = (limit, max = 100) => { if (!Number.isSafeInteger(limit) || limit < 1 || limit > max) fail('INVALID_REQUEST'); return limit; };
 const sequence = value => {
@@ -256,7 +256,7 @@ export class SqlitePersonStore {
   }
   append(episode, kind, data) {
     // Call proof/publication events are emitted only by their transactional methods.
-    if (['call_started', 'call_output', 'call_failed', 'capability_created'].includes(kind)) fail('INVALID_REQUEST');
+    if (['call_started', 'call_output', 'call_failed', 'capability_created', 'capability_finalized'].includes(kind)) fail('INVALID_REQUEST');
     const p = this.own(episode);
     const record = this.one('episodes', this.episodeScope(episode), ' AND id = ?', [episode.id]);
     if (!record || record.status !== 'running') fail('STALE');
@@ -268,7 +268,7 @@ export class SqlitePersonStore {
   startCall(episode, data) {
     const p = this.own(episode), scope = this.episodeScope(episode);
     const record = this.one('episodes', scope, ' AND id = ?', [episode.id]);
-    if (!record || record.status !== 'running' || record.openCall) fail('STALE');
+    if (!record || record.status !== 'running' || record.openCall || record.openCapability) fail('STALE');
     p.writeSerial++; this.put('persons', p);
     record.openCall = { callId: data.callId, requested: data.requested, effective: data.effective, ...(data.manifest ? { manifest: data.manifest } : {}) };
     this.put('episodes', record);
@@ -292,6 +292,43 @@ export class SqlitePersonStore {
     });
     return live;
   }
+  startCapability(episode, data) {
+    const p = this.own(episode), scope = this.episodeScope(episode);
+    const record = this.one('episodes', scope, ' AND id = ?', [episode.id]);
+    const proof = this.one('traces', scope, " AND json_extract(record, '$.episodeId') = ? AND json_extract(record, '$.kind') = 'call_output' AND json_extract(record, '$.callId') = ? AND json_extract(record, '$.output.complete') = 1", [episode.id, data.callId]);
+    if (!record || record.status !== 'running' || record.openCall || record.openCapability || !proof) fail('STALE');
+    const prior = this.one('traces', scope, " AND json_extract(record, '$.episodeId') = ? AND json_extract(record, '$.kind') = 'capability_started' AND json_extract(record, '$.callId') = ?", [episode.id, data.callId]);
+    if (prior) fail('STALE');
+    record.openCapability = { ...data, invocationHash: digest(data.capability) };
+    this.put('episodes', record);
+    p.writeSerial++; this.put('persons', p);
+    return this.trace(episode.ownerId, episode.id, 'capability_started', data);
+  }
+  /** Original started invocation only; consuming this slot never restores cognitive authority. */
+  finalizeCapability(episode, { callId, capability, result, code = null, terminalCode = null }) {
+    const scope = this.episodeScope(episode), record = this.one('episodes', scope, ' AND id = ?', [episode.id]);
+    if (!record || record.workerId !== episode.workerId || record.epoch !== episode.epoch ||
+        record.baseStateVersion !== episode.baseStateVersion || record.controlVersion !== episode.controlVersion || record.inputWatermark !== episode.inputWatermark ||
+        record.openCapability?.callId !== callId || record.openCapability.invocationHash !== digest(capability) ||
+        !['running', 'cancelled', 'interrupted', 'failed'].includes(record.status)) return false;
+    const p = record.status === 'running' && this.fenced(episode);
+    const live = Boolean(p && !terminalCode);
+    const started = record.openCapability;
+    const failed = Boolean(code || result?.ok === false);
+    const outcome = failed ? 'capability_failed' : 'capability_result';
+    const data = { callId, ...(started.capabilityManifest ? { capabilityManifest: started.capabilityManifest } : {}),
+      ...(failed ? { capabilityId: started.capability.id, code: code || result.code } : { capability: started.capability }),
+      ...(result !== undefined ? { result } : {}) };
+    delete record.openCapability; this.put('episodes', record);
+    if (live) {
+      const experience = recordCapabilityExperience(p.capabilityExperience, record, outcome, data, this.now.toISOString());
+      if (experience) { p.capabilityExperience = experience; this.put('persons', p); }
+    }
+    this.trace(episode.ownerId, episode.id, live ? outcome : 'capability_finalized', { ...data,
+      ...(!live ? { capability: started.capability, workerId: record.workerId, outcome, afterTerminal: true, accepted: false,
+        terminalCode: terminalCode || record.terminalCode || 'STALE' } : {}) });
+    return live;
+  }
   createdCapabilities(episode) {
     this.own(episode);
     return this.rows('created_capabilities', this.episodeScope(episode), ' ORDER BY id ASC LIMIT 32').map(publicDoc);
@@ -392,11 +429,11 @@ export class SqlitePersonStore {
     if (Object.keys(settings).length) this.trace(ownerId, null, 'settings', { settings: settingsView(p.settings), ...(name !== undefined ? { name: p.name } : {}) });
     return { settings: settingsView(p.settings), person: this.personView(p) };
   }
-  inspect(ownerId, options) {
+  inspect(ownerId, options, nativeToolIds) {
     const { section, cursor, limit } = inspectRequest(options);
     this.getPerson(ownerId);
     const scope = this.scope(ownerId);
-    if (section === 'skills') return inspectCapabilities(this.rows('created_capabilities', scope, ' ORDER BY id ASC LIMIT 32'), { cursor, limit });
+    if (section === 'skills') return inspectCapabilities(this.rows('created_capabilities', scope, ' ORDER BY id ASC LIMIT 32'), { cursor, limit }, nativeToolIds);
     const records = this.rows('concepts', scope, ' AND (? IS NULL OR id > ?) ORDER BY id ASC LIMIT ?', [cursor, cursor, limit + 1]);
     return inspectionPage(records, limit, 'id', conceptView);
   }