8cdc0ff449
This merge brings FN-3155's plugin `createAiSession` API (types, DI hooks, engine adapter, context wiring, docs, and tests), FN-3056's task title sanitization, and FN-3129's tokenized footer and mobile initialization for MissionManager. It also adds CentralCore Docker node management, a new AddNodeM Fusion-Task-Id: FN-3155
60 lines
2.0 KiB
TypeScript
60 lines
2.0 KiB
TypeScript
/**
|
|
* Shared lazy accessor for `@fusion/engine`'s `createFnAgent`.
|
|
*
|
|
* Core can't import engine statically (engine depends on core, so a static
|
|
* import would create a cycle). Instead, engine wires its `createFnAgent` in
|
|
* via `setCreateFnAgent` when its module loads, and consumers in core read it
|
|
* back through `getFnAgent`.
|
|
*
|
|
* If engine never loads (e.g. tests that only import core), `getFnAgent`
|
|
* returns `undefined` and callers degrade gracefully.
|
|
*/
|
|
|
|
import type { CreateAiSessionFactory } from "./plugin-types.js";
|
|
|
|
// Engine exports a function type we intentionally don't pull in here — importing
|
|
// the type would reintroduce the cycle this module is designed to avoid.
|
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
type CreateFnAgent = any;
|
|
|
|
let createFnAgent: CreateFnAgent | undefined;
|
|
let createAiSessionFactory: CreateAiSessionFactory | undefined;
|
|
|
|
/** Shape of a message in an agent session's state. */
|
|
export interface AgentMessage {
|
|
role: string;
|
|
content?: string | Array<{ type: string; text: string }>;
|
|
}
|
|
|
|
/**
|
|
* Wire engine's `createFnAgent` into core. Called by `@fusion/engine` at module
|
|
* load. Tests can also call this with a stub.
|
|
*/
|
|
export function setCreateFnAgent(fn: CreateFnAgent | undefined): void {
|
|
createFnAgent = fn;
|
|
}
|
|
|
|
/**
|
|
* Returns `createFnAgent` from `@fusion/engine`, or `undefined` if engine has
|
|
* not registered itself yet (typical in tests).
|
|
*/
|
|
export async function getFnAgent(): Promise<CreateFnAgent> {
|
|
return createFnAgent;
|
|
}
|
|
|
|
/**
|
|
* Wire engine's plugin-facing AI session factory into core.
|
|
* Called by `@fusion/engine` at module load; tests may register stubs.
|
|
*/
|
|
export function setCreateAiSessionFactory(fn: CreateAiSessionFactory | undefined): void {
|
|
createAiSessionFactory = fn;
|
|
}
|
|
|
|
/**
|
|
* Returns engine-registered plugin AI session factory, or `undefined` when
|
|
* engine hasn't registered it (common in isolated core tests).
|
|
*/
|
|
export async function getCreateAiSessionFactory(): Promise<CreateAiSessionFactory | undefined> {
|
|
return createAiSessionFactory;
|
|
}
|