@framers/agentos 0.12.12 → 0.12.14

package/dist/api/runtime/capabilityContract.d.ts

@@ -1,4 +1,9 @@
-export type CapabilitySurface = 'agent' | 'generation' | 'runtime';
+/**
+ * Where a config field is read: `agent` (the lightweight `agent()` helper on its
+ * legacy runtime), `generation` (generateText and streamText), `runtime` (the full
+ * AgentOS runtime) and `gmi` (`agent({ runtime: 'gmi' })` and `gmi()`).
+ */
+export type CapabilitySurface = 'agent' | 'generation' | 'runtime' | 'gmi';
 export type CapabilitySupport = 'enforced' | 'partially_enforced' | 'accepted_but_deferred' | 'runtime_only';
 export declare const CAPABILITY_KEYS: readonly ["tools", "memory", "rag", "discovery", "guardrails", "security", "permissions", "hitl", "emergent", "voice", "channels", "output", "provenance", "observability", "controls"];
 export type CapabilityKey = (typeof CAPABILITY_KEYS)[number];
@@ -7,76 +12,91 @@ export declare const BASE_AGENT_CONFIG_CAPABILITY_CONTRACT: {
         readonly agent: "enforced";
         readonly generation: "enforced";
         readonly runtime: "enforced";
+        readonly gmi: "enforced";
     };
     readonly memory: {
         readonly agent: "partially_enforced";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "enforced";
     };
     readonly rag: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "accepted_but_deferred";
     };
     readonly discovery: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "accepted_but_deferred";
     };
     readonly guardrails: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "partially_enforced";
         readonly runtime: "enforced";
+        readonly gmi: "accepted_but_deferred";
     };
     readonly security: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "accepted_but_deferred";
     };
     readonly permissions: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "partially_enforced";
         readonly runtime: "enforced";
+        readonly gmi: "accepted_but_deferred";
     };
     readonly hitl: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "accepted_but_deferred";
     };
     readonly emergent: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "accepted_but_deferred";
     };
     readonly voice: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "runtime_only";
     };
     readonly channels: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "runtime_only";
     };
     readonly output: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "accepted_but_deferred";
     };
     readonly provenance: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "accepted_but_deferred";
     };
     readonly observability: {
         readonly agent: "partially_enforced";
         readonly generation: "partially_enforced";
         readonly runtime: "enforced";
+        readonly gmi: "partially_enforced";
     };
     readonly controls: {
         readonly agent: "partially_enforced";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "partially_enforced";
     };
 };
 export declare function getCapabilitySupport(surface: CapabilitySurface, key: CapabilityKey): CapabilitySupport;

package/dist/api/runtime/capabilityContract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capabilityContract.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/capabilityContract.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,CAAC;AAEnE,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,oBAAoB,GACpB,uBAAuB,GACvB,cAAc,CAAC;AAEnB,eAAO,MAAM,eAAe,yLAgBlB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBsC,CAAC;AAEzF,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,iBAAiB,EAC1B,GAAG,EAAE,aAAa,GACjB,iBAAiB,CAEnB"}
+{"version":3,"file":"capabilityContract.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/capabilityContract.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,KAAK,CAAC;AAE3E,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,oBAAoB,GACpB,uBAAuB,GACvB,cAAc,CAAC;AAEnB,eAAO,MAAM,eAAe,yLAgBlB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBsC,CAAC;AAEzF,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,iBAAiB,EAC1B,GAAG,EAAE,aAAa,GACjB,iBAAiB,CAEnB"}

package/dist/api/runtime/capabilityContract.js

@@ -16,21 +16,21 @@ export const CAPABILITY_KEYS = [
     'controls',
 ];
 export const BASE_AGENT_CONFIG_CAPABILITY_CONTRACT = {
-    tools: { agent: 'enforced', generation: 'enforced', runtime: 'enforced' },
-    memory: { agent: 'partially_enforced', generation: 'runtime_only', runtime: 'enforced' },
-    rag: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced' },
-    discovery: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced' },
-    guardrails: { agent: 'accepted_but_deferred', generation: 'partially_enforced', runtime: 'enforced' },
-    security: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced' },
-    permissions: { agent: 'accepted_but_deferred', generation: 'partially_enforced', runtime: 'enforced' },
-    hitl: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced' },
-    emergent: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced' },
-    voice: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced' },
-    channels: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced' },
-    output: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced' },
-    provenance: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced' },
-    observability: { agent: 'partially_enforced', generation: 'partially_enforced', runtime: 'enforced' },
-    controls: { agent: 'partially_enforced', generation: 'runtime_only', runtime: 'enforced' },
+    tools: { agent: 'enforced', generation: 'enforced', runtime: 'enforced', gmi: 'enforced' },
+    memory: { agent: 'partially_enforced', generation: 'runtime_only', runtime: 'enforced', gmi: 'enforced' },
+    rag: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced', gmi: 'accepted_but_deferred' },
+    discovery: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced', gmi: 'accepted_but_deferred' },
+    guardrails: { agent: 'accepted_but_deferred', generation: 'partially_enforced', runtime: 'enforced', gmi: 'accepted_but_deferred' },
+    security: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced', gmi: 'accepted_but_deferred' },
+    permissions: { agent: 'accepted_but_deferred', generation: 'partially_enforced', runtime: 'enforced', gmi: 'accepted_but_deferred' },
+    hitl: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced', gmi: 'accepted_but_deferred' },
+    emergent: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced', gmi: 'accepted_but_deferred' },
+    voice: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced', gmi: 'runtime_only' },
+    channels: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced', gmi: 'runtime_only' },
+    output: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced', gmi: 'accepted_but_deferred' },
+    provenance: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced', gmi: 'accepted_but_deferred' },
+    observability: { agent: 'partially_enforced', generation: 'partially_enforced', runtime: 'enforced', gmi: 'partially_enforced' },
+    controls: { agent: 'partially_enforced', generation: 'runtime_only', runtime: 'enforced', gmi: 'partially_enforced' },
 };
 export function getCapabilitySupport(surface, key) {
     return BASE_AGENT_CONFIG_CAPABILITY_CONTRACT[key][surface];

package/dist/api/runtime/capabilityContract.js.map

@@ -1 +1 @@
-{"version":3,"file":"capabilityContract.js","sourceRoot":"","sources":["../../../src/api/runtime/capabilityContract.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO;IACP,QAAQ;IACR,KAAK;IACL,WAAW;IACX,YAAY;IACZ,UAAU;IACV,aAAa;IACb,MAAM;IACN,UAAU;IACV,OAAO;IACP,UAAU;IACV,QAAQ;IACR,YAAY;IACZ,eAAe;IACf,UAAU;CACF,CAAC;AAIX,MAAM,CAAC,MAAM,qCAAqC,GAAG;IACnD,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE;IACzE,MAAM,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;IACxF,GAAG,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;IACxF,SAAS,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;IAC9F,UAAU,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,oBAAoB,EAAE,OAAO,EAAE,UAAU,EAAE;IACrG,QAAQ,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;IAC7F,WAAW,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,oBAAoB,EAAE,OAAO,EAAE,UAAU,EAAE;IACtG,IAAI,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;IACzF,QAAQ,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;IAC7F,KAAK,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;IAC1F,QAAQ,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;IAC7F,MAAM,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;IAC3F,UAAU,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;IAC/F,aAAa,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,oBAAoB,EAAE,OAAO,EAAE,UAAU,EAAE;IACrG,QAAQ,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;CACJ,CAAC;AAEzF,MAAM,UAAU,oBAAoB,CAClC,OAA0B,EAC1B,GAAkB;IAElB,OAAO,qCAAqC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"capabilityContract.js","sourceRoot":"","sources":["../../../src/api/runtime/capabilityContract.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO;IACP,QAAQ;IACR,KAAK;IACL,WAAW;IACX,YAAY;IACZ,UAAU;IACV,aAAa;IACb,MAAM;IACN,UAAU;IACV,OAAO;IACP,UAAU;IACV,QAAQ;IACR,YAAY;IACZ,eAAe;IACf,UAAU;CACF,CAAC;AAIX,MAAM,CAAC,MAAM,qCAAqC,GAAG;IACnD,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE;IAC1F,MAAM,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE;IACzG,GAAG,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,uBAAuB,EAAE;IACtH,SAAS,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,uBAAuB,EAAE;IAC5H,UAAU,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,oBAAoB,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,uBAAuB,EAAE;IACnI,QAAQ,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,uBAAuB,EAAE;IAC3H,WAAW,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,oBAAoB,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,uBAAuB,EAAE;IACpI,IAAI,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,uBAAuB,EAAE;IACvH,QAAQ,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,uBAAuB,EAAE;IAC3H,KAAK,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,cAAc,EAAE;IAC/G,QAAQ,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,cAAc,EAAE;IAClH,MAAM,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,uBAAuB,EAAE;IACzH,UAAU,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,uBAAuB,EAAE;IAC7H,aAAa,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,oBAAoB,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,oBAAoB,EAAE;IAChI,QAAQ,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,oBAAoB,EAAE;CAC/B,CAAC;AAEzF,MAAM,UAAU,oBAAoB,CAClC,OAA0B,EAC1B,GAAkB;IAElB,OAAO,qCAAqC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;AAC7D,CAAC"}

package/dist/api/runtime/gmiCognition.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @file gmiCognition.ts
+ * Cognition profiles for GMIs built from agent options (`agent({ runtime: 'gmi' })`).
+ *
+ * `light` (the default) is a GMI with its reasoning trace and nothing else
+ * unless `memory` is set. `full` adds cognitive memory with every mechanism,
+ * sentiment tracking and every metaprompt preset. A {@link CognitionConfig}
+ * sets each switch on its own.
+ */
+import type { MemoryConfig } from '../types.js';
+import type { CognitiveMechanismsConfig } from '../../cognition/memory/mechanisms/types.js';
+import type { SentimentTrackingConfig } from '../../cognition/substrate/personas/IPersonaDefinition.js';
+/** A named cognition profile. */
+export type CognitionProfile = 'light' | 'full';
+/** A metaprompt preset, named as `SentimentTrackingConfig.presets` names it. */
+export type MetapromptPreset = Exclude<NonNullable<SentimentTrackingConfig['presets']>[number], 'all'>;
+/** Each cognition switch set explicitly, in place of a named profile. */
+export interface CognitionConfig {
+    /** Cognitive memory: false, true (defaults) or a MemoryConfig. Unset: the agent's `memory` option. */
+    memory?: boolean | MemoryConfig;
+    /**
+     * Memory mechanisms: true (the agent's `cognitiveMechanisms`, or every
+     * mechanism at its defaults), false (none) or a per-mechanism config.
+     * Unset means true. Needs memory.
+     */
+    mechanisms?: boolean | CognitiveMechanismsConfig;
+    /** Sentiment tracking: every user turn is scored by the utility AI's lexicon. */
+    sentiment?: boolean;
+    /**
+     * Metaprompt presets: `'all'`, a list of presets, or false. Needs
+     * `sentiment`: the presets answer the events sentiment tracking raises.
+     */
+    metaprompts?: 'all' | MetapromptPreset[] | false;
+}
+/** What a GMI built from agent options runs. */
+export interface ResolvedCognition {
+    profile: CognitionProfile | 'custom';
+    /** The cognitive memory config, or false for none. */
+    memory: MemoryConfig | false;
+    /** The mechanisms config the memory manager runs; undefined when memory or the mechanisms are off. */
+    mechanisms: CognitiveMechanismsConfig | undefined;
+    sentiment: boolean;
+    /** The metaprompt presets; false when sentiment is off. */
+    metaprompts: 'all' | MetapromptPreset[] | false;
+}
+/** The agent options {@link resolveCognition} reads. */
+export interface CognitionInputs {
+    cognition?: CognitionProfile | CognitionConfig;
+    memory?: boolean | MemoryConfig;
+    cognitiveMechanisms?: CognitiveMechanismsConfig;
+}
+/**
+ * Resolves an agent's `cognition`, `memory` and `cognitiveMechanisms` options
+ * into the switches a GMI runs with.
+ *
+ * - `light`: memory only when `memory` is set (then every mechanism, or the
+ *   agent's `cognitiveMechanisms`); no sentiment tracking, no metaprompts.
+ * - `full`: memory unless `memory: false`, every mechanism (or the agent's
+ *   `cognitiveMechanisms`), sentiment tracking and every metaprompt preset.
+ * - A {@link CognitionConfig}: each switch as set, with `memory` falling back
+ *   to the agent's `memory` option.
+ *
+ * @throws {Error} When `cognition` names an unknown profile or an unknown metaprompt preset.
+ */
+export declare function resolveCognition(opts: CognitionInputs): ResolvedCognition;
+//# sourceMappingURL=gmiCognition.d.ts.map

package/dist/api/runtime/gmiCognition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmiCognition.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/gmiCognition.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AAC5F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0DAA0D,CAAC;AAGxG,iCAAiC;AACjC,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,CAAC;AAEhD,gFAAgF;AAChF,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;AAEvG,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,sGAAsG;IACtG,MAAM,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC;IAChC;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,yBAAyB,CAAC;IACjD,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,KAAK,GAAG,gBAAgB,EAAE,GAAG,KAAK,CAAC;CAClD;AAED,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,gBAAgB,GAAG,QAAQ,CAAC;IACrC,sDAAsD;IACtD,MAAM,EAAE,YAAY,GAAG,KAAK,CAAC;IAC7B,sGAAsG;IACtG,UAAU,EAAE,yBAAyB,GAAG,SAAS,CAAC;IAClD,SAAS,EAAE,OAAO,CAAC;IACnB,2DAA2D;IAC3D,WAAW,EAAE,KAAK,GAAG,gBAAgB,EAAE,GAAG,KAAK,CAAC;CACjD;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAAC;IAC/C,MAAM,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC;IAChC,mBAAmB,CAAC,EAAE,yBAAyB,CAAC;CACjD;AAuBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,iBAAiB,CAsBzE"}

package/dist/api/runtime/gmiCognition.js

@@ -0,0 +1,58 @@
+import { SENTIMENT_PRESET_IDS } from '../../cognition/substrate/personas/personaNormalization.js';
+function memoryOf(value) {
+    if (value === undefined || value === false)
+        return false;
+    return value === true ? {} : value;
+}
+function presetsOf(value) {
+    if (value === undefined || value === false)
+        return false;
+    if (value === 'all')
+        return 'all';
+    if (!Array.isArray(value)) {
+        throw new Error("cognition.metaprompts must be 'all', a list of presets, or false.");
+    }
+    const unknown = value.filter((name) => !Object.prototype.hasOwnProperty.call(SENTIMENT_PRESET_IDS, name));
+    if (unknown.length > 0) {
+        throw new Error(`cognition.metaprompts: unknown preset ${unknown.map((name) => `'${String(name)}'`).join(', ')}; ` +
+            `use 'all' or a list of ${Object.keys(SENTIMENT_PRESET_IDS).join(', ')}.`);
+    }
+    return [...value];
+}
+/**
+ * Resolves an agent's `cognition`, `memory` and `cognitiveMechanisms` options
+ * into the switches a GMI runs with.
+ *
+ * - `light`: memory only when `memory` is set (then every mechanism, or the
+ *   agent's `cognitiveMechanisms`); no sentiment tracking, no metaprompts.
+ * - `full`: memory unless `memory: false`, every mechanism (or the agent's
+ *   `cognitiveMechanisms`), sentiment tracking and every metaprompt preset.
+ * - A {@link CognitionConfig}: each switch as set, with `memory` falling back
+ *   to the agent's `memory` option.
+ *
+ * @throws {Error} When `cognition` names an unknown profile or an unknown metaprompt preset.
+ */
+export function resolveCognition(opts) {
+    const c = opts.cognition ?? 'light';
+    if (c === 'light') {
+        const memory = memoryOf(opts.memory);
+        return { profile: 'light', memory, mechanisms: memory ? (opts.cognitiveMechanisms ?? {}) : undefined, sentiment: false, metaprompts: false };
+    }
+    if (c === 'full') {
+        const memory = memoryOf(opts.memory ?? true);
+        return { profile: 'full', memory, mechanisms: memory ? (opts.cognitiveMechanisms ?? {}) : undefined, sentiment: true, metaprompts: 'all' };
+    }
+    if (typeof c !== 'object') {
+        throw new Error(`cognition: unknown profile '${String(c)}'; use 'light', 'full' or a CognitionConfig.`);
+    }
+    const memory = memoryOf(c.memory ?? opts.memory);
+    const mechanisms = !memory || c.mechanisms === false
+        ? undefined
+        : c.mechanisms === true || c.mechanisms === undefined
+            ? (opts.cognitiveMechanisms ?? {})
+            : c.mechanisms;
+    const sentiment = c.sentiment === true;
+    const metaprompts = presetsOf(c.metaprompts);
+    return { profile: 'custom', memory, mechanisms, sentiment, metaprompts: sentiment ? metaprompts : false };
+}
+//# sourceMappingURL=gmiCognition.js.map

package/dist/api/runtime/gmiCognition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmiCognition.js","sourceRoot":"","sources":["../../../src/api/runtime/gmiCognition.ts"],"names":[],"mappings":"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"}

package/dist/api/runtime/gmiPersona.d.ts

@@ -0,0 +1,16 @@
+import { type AgentOptions } from '../agent.js';
+import type { IPersonaDefinition } from '../../cognition/substrate/personas/IPersonaDefinition.js';
+import type { ITool } from '../../core/tools/ITool.js';
+import type { ResolvedCognition } from './gmiCognition.js';
+/** The session store bounds history (spec D10), so the GMI's own count window stays out of the way. */
+export declare const GMI_SESSION_MAX_HISTORY_MESSAGES = 100000;
+/**
+ * Builds the persona of a GMI from agent options (spec D6).
+ *
+ * @param opts - The agent's options.
+ * @param cognition - The resolved profile ({@link resolveCognition}): sentiment tracking and metaprompts.
+ * @param tools - The agent's tools, adapted: they decide the chain-of-thought text and the persona's capabilities.
+ * @throws {Error} When no provider or model can be resolved, as `generateText` throws.
+ */
+export declare function personaFromAgentOptions(opts: AgentOptions, cognition: ResolvedCognition, tools: ITool[]): IPersonaDefinition;
+//# sourceMappingURL=gmiPersona.d.ts.map

package/dist/api/runtime/gmiPersona.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmiPersona.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/gmiPersona.ts"],"names":[],"mappings":"AAYA,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAKnE,OAAO,KAAK,EAAE,kBAAkB,EAA2B,MAAM,0DAA0D,CAAC;AAC5H,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAEvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,uGAAuG;AACvG,eAAO,MAAM,gCAAgC,SAAU,CAAC;AAsCxD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,kBAAkB,CAsB5H"}

package/dist/api/runtime/gmiPersona.js

@@ -0,0 +1,91 @@
+/**
+ * @file gmiPersona.ts
+ * The persona of a GMI built from agent options (`agent({ runtime: 'gmi' })`).
+ *
+ * The base system prompt is the text the legacy path sends: `buildSystemPrompt(opts)`
+ * (or the joined `systemBlocks`), with the chain-of-thought instruction first when
+ * the agent has tools, as `generateText` puts it. The completion options are the
+ * ones `agent()` forwards on every call. Sentiment presets are expanded into
+ * metaprompts, as the persona loaders expand them, because the GMI runs only the
+ * persona's `metaPrompts`.
+ */
+import { createHash, randomUUID } from 'node:crypto';
+import { buildSystemPrompt } from '../agent.js';
+import { resolveChainOfThought } from '../generateText.js';
+import { resolveModelOption } from '../model.js';
+import { normalizeHexacoTraits } from '../../cognition/substrate/personas/hexaco.js';
+import { normalizePersonaDefinition } from '../../cognition/substrate/personas/personaNormalization.js';
+/** The session store bounds history (spec D10), so the GMI's own count window stays out of the way. */
+export const GMI_SESSION_MAX_HISTORY_MESSAGES = 100000;
+/**
+ * A stable persona id from the agent's name: a lowercase ASCII slug, or, for a
+ * name with no Latin letters or digits, `agent-` and a hash of the name.
+ */
+function personaIdFor(name) {
+    const slug = name
+        .normalize('NFKD')
+        .replace(/[̀-ͯ]/g, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return slug || `agent-${createHash('sha256').update(name).digest('hex').slice(0, 12)}`;
+}
+/** The completion options `agent()` forwards on every call (its `baseOpts`), unset ones left out. */
+function completionOptionsOf(opts) {
+    const out = {};
+    const maxTokens = opts.maxTokens ?? opts.controls?.maxTotalTokens;
+    if (maxTokens !== undefined)
+        out.maxTokens = maxTokens;
+    if (opts.controls?.maxDurationMs !== undefined)
+        out.requestTimeout = opts.controls.maxDurationMs;
+    if (opts.thinking !== undefined)
+        out.thinking = opts.thinking;
+    if (opts.effort !== undefined)
+        out.effort = opts.effort;
+    if (opts.customModelParams !== undefined)
+        out.customModelParams = opts.customModelParams;
+    if (opts.cache !== undefined)
+        out.cache = opts.cache;
+    return out;
+}
+function basePrompt(opts, hasTools) {
+    const system = opts.systemBlocks
+        ? opts.systemBlocks.map((block) => block.text).filter(Boolean).join('\n\n')
+        : buildSystemPrompt(opts) ?? '';
+    const cot = hasTools ? resolveChainOfThought(opts.chainOfThought ?? true) : undefined;
+    if (!cot)
+        return system;
+    return system ? `${cot}\n\n${system}` : cot;
+}
+/**
+ * Builds the persona of a GMI from agent options (spec D6).
+ *
+ * @param opts - The agent's options.
+ * @param cognition - The resolved profile ({@link resolveCognition}): sentiment tracking and metaprompts.
+ * @param tools - The agent's tools, adapted: they decide the chain-of-thought text and the persona's capabilities.
+ * @throws {Error} When no provider or model can be resolved, as `generateText` throws.
+ */
+export function personaFromAgentOptions(opts, cognition, tools) {
+    const { providerId, modelId } = resolveModelOption({ provider: opts.provider, model: opts.model, baseUrl: opts.baseUrl }, 'text');
+    const name = opts.name?.trim() || 'Agent';
+    const firstLine = opts.instructions?.split('\n').map((line) => line.trim()).find(Boolean);
+    const completion = completionOptionsOf(opts);
+    const presets = cognition.metaprompts === 'all' ? ['all'] : cognition.metaprompts || [];
+    const persona = {
+        id: opts.name?.trim() ? personaIdFor(opts.name.trim()) : `agent-${randomUUID()}`,
+        name,
+        description: firstLine ?? name,
+        version: '1.0.0',
+        baseSystemPrompt: basePrompt(opts, tools.length > 0),
+        ...(opts.personality ? { personalityTraits: normalizeHexacoTraits(opts.personality) } : {}),
+        defaultProviderId: providerId,
+        defaultModelId: modelId,
+        ...(Object.keys(completion).length > 0 ? { defaultModelCompletionOptions: completion } : {}),
+        allowedCapabilities: [...new Set(tools.flatMap((tool) => tool.requiredCapabilities ?? []))],
+        conversationContextConfig: { maxMessages: GMI_SESSION_MAX_HISTORY_MESSAGES },
+        sentimentTracking: cognition.sentiment ? { enabled: true, presets } : { enabled: false },
+        ...(cognition.metaprompts === false ? { metaPrompts: [] } : {}),
+    };
+    return normalizePersonaDefinition(persona);
+}
+//# sourceMappingURL=gmiPersona.js.map

package/dist/api/runtime/gmiPersona.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmiPersona.js","sourceRoot":"","sources":["../../../src/api/runtime/gmiPersona.ts"],"names":[],"mappings":"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"}

package/dist/api/runtime/gmiResults.d.ts

@@ -0,0 +1,98 @@
+/**
+ * @file gmiResults.ts
+ * Folds a GMI turn's output chunks into the result shapes of `generateText`
+ * (`session.send()`) and `streamText` (`session.stream()`) on the GMI path
+ * (`agent({ runtime: 'gmi' })`).
+ *
+ * The rules are streamText's: the turn's text is the latest step that produced
+ * text; usage adds each step's STEP_FINISHED usage once (USAGE_UPDATE carries a
+ * request's running total) plus the billed usage of attempts that failed before
+ * any output; a run that called tools and produced no text ends as
+ * `'tool-calls'`; an ERROR chunk ends it as `'error'` with the GMI's code.
+ */
+import { GMIError } from '../../core/utils/errors.js';
+import { type GMIOutputChunk, type StepFinishedChunkPayload, type ToolResultChunkPayload } from '../../cognition/substrate/IGMI.js';
+import { type GenerateTextResult, type TokenUsage, type ToolCallRecord } from '../generateText.js';
+import { type StreamTextResult } from '../streamText.js';
+import type { SessionTranscriptMessage } from '../sessionTranscript.js';
+/** The error a turn ended with, as the GMI reported it. */
+export interface GmiTurnError {
+    code?: string;
+    message: string;
+    details?: unknown;
+}
+/** An attempt that failed before any output and was billed (reported on a USAGE_UPDATE with `metadata.attemptFailed`). */
+export interface GmiFailedAttempt {
+    providerId?: string;
+    modelId?: string;
+    usage: TokenUsage;
+}
+/** The message a failed tool result carries. */
+export declare function toolErrorMessage(result: ToolResultChunkPayload): string;
+/**
+ * Accumulates one turn's chunks. `push` every chunk in order; read the result
+ * once the turn has ended (or at any point for a partial view).
+ */
+export declare class GmiTurnFolder {
+    /** The STEP_FINISHED payloads, in order. */
+    readonly steps: StepFinishedChunkPayload[];
+    /** Every requested call in order, with its result once the TOOL_RESULT arrived. */
+    private readonly calls;
+    private readonly overrides;
+    private readonly failed;
+    private failure;
+    push(chunk: GMIOutputChunk): void;
+    /** Marks the turn failed by a thrown error (the turn's generator itself threw). An ERROR chunk already seen wins. */
+    fail(error: unknown): void;
+    /** Replaces a step's text (`onAfterGeneration`), in the result and in what the session stores. */
+    overrideStepText(stepIndex: number, text: string): void;
+    /** A step's text as the result reports it: a schema answer as its JSON string, else the hook's replacement, else the step's own text. */
+    stepText(step: StepFinishedChunkPayload): string;
+    /** The latest step that produced text, streamText's rule. */
+    text(): string;
+    /** Each step's usage once, plus every billed failed attempt. */
+    usage(): TokenUsage;
+    /** The billed attempts that failed before any output, in order. */
+    failedAttempts(): GmiFailedAttempt[];
+    /** Every call the model requested, with its result or error. */
+    toolCalls(): ToolCallRecord[];
+    /** The latest schema answer a step carried, if any. */
+    structuredOutput(): unknown;
+    error(): GmiTurnError | undefined;
+    finishReason(): GenerateTextResult['finishReason'];
+    /** The error the turn ended with, as a GMIError keeping the GMI's code. */
+    toError(): GMIError | undefined;
+    /**
+     * The turn as `generateText` reports a run: provider, model and response
+     * metadata from the last step, the text, the usage, the tool calls and the
+     * finish reason.
+     *
+     * @param transcriptDelta - The messages the turn added to the session store.
+     */
+    toGenerateTextResult(transcriptDelta?: SessionTranscriptMessage[]): GenerateTextResult;
+}
+/** Options for {@link streamFromGmiTurn}. */
+export interface GmiStreamOptions {
+    /**
+     * A folder the turn already pushes every chunk into (the session's, which
+     * carries the `onAfterGeneration` replacements). Without one, the stream
+     * folds the chunks itself.
+     */
+    folder?: GmiTurnFolder;
+}
+/**
+ * A `StreamTextResult` over a GMI turn. The turn is drained eagerly, so every
+ * promise settles whether the caller iterates, stops iterating early, or never
+ * iterates; `textStream` and `fullStream` replay what arrived and wait for more.
+ *
+ * `textStream` yields every TEXT_DELTA as it arrives. `fullStream` maps
+ * TEXT_DELTA to `text`, TOOL_CALL_REQUEST to `tool-call`, TOOL_RESULT to
+ * `tool-result` and ERROR (or a thrown error) to a final `error` part. `text`
+ * is the latest step's text; after an error it is the text the failed step
+ * delivered, as streamText resolves it.
+ *
+ * @param turn - The turn's chunks.
+ * @param options - A caller-owned folder; see {@link GmiStreamOptions}.
+ */
+export declare function streamFromGmiTurn(turn: AsyncIterable<GMIOutputChunk>, options?: GmiStreamOptions): StreamTextResult;
+//# sourceMappingURL=gmiResults.d.ts.map

package/dist/api/runtime/gmiResults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmiResults.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/gmiResults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,QAAQ,EAAgB,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAE7B,KAAK,sBAAsB,EAC5B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAiB,KAAK,kBAAkB,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAClH,OAAO,EAAgD,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACvG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAExE,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,0HAA0H;AAC1H,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;CACnB;AAiBD,gDAAgD;AAChD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAGvE;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,wBAAwB,EAAE,CAAM;IAChD,mFAAmF;IACnF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyE;IAC/F,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,OAAO,CAA2B;IAE1C,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IA0CjC,qHAAqH;IACrH,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAQ1B,kGAAkG;IAClG,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIvD,yIAAyI;IACzI,QAAQ,CAAC,IAAI,EAAE,wBAAwB,GAAG,MAAM;IAKhD,6DAA6D;IAC7D,IAAI,IAAI,MAAM;IAQd,gEAAgE;IAChE,KAAK,IAAI,UAAU;IAOnB,mEAAmE;IACnE,cAAc,IAAI,gBAAgB,EAAE;IAIpC,gEAAgE;IAChE,SAAS,IAAI,cAAc,EAAE;IAS7B,uDAAuD;IACvD,gBAAgB,IAAI,OAAO;IAO3B,KAAK,IAAI,YAAY,GAAG,SAAS;IAIjC,YAAY,IAAI,kBAAkB,CAAC,cAAc,CAAC;IAQlD,2EAA2E;IAC3E,OAAO,IAAI,QAAQ,GAAG,SAAS;IAK/B;;;;;;OAMG;IACH,oBAAoB,CAAC,eAAe,CAAC,EAAE,wBAAwB,EAAE,GAAG,kBAAkB;CAgBvF;AAeD,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC,cAAc,CAAC,EAAE,OAAO,GAAE,gBAAqB,GAAG,gBAAgB,CAiHvH"}