@springbrand/agent-runtime 0.1.3-alpha.0 → 0.1.3-alpha.10

package/src/runtime-definition.ts

@@ -0,0 +1,175 @@
+import type { SkillSource } from "agents/skills";
+import type { ExecutionLevel } from "./lib/execution-level";
+import type {
+  RuntimeGatewayPort,
+  RuntimeModelUsageEvent,
+  RuntimePlatformPort,
+  RuntimeProviderPort,
+  RuntimeSkillScriptPolicy,
+  RuntimeToolStartEvent,
+  RuntimeTurnMessage,
+} from "./kernel/bindings";
+import type {
+  RuntimeDenyPolicy,
+  RuntimeMcpServer,
+  RuntimeMemoryProfile,
+  ThinkingEffort,
+} from "./kernel/profile";
+import type { RuntimeExtensionConfig } from "./kernel/extensions";
+import type { RuntimeActivityProjection } from "./kernel/state";
+import type { RuntimeDegradation } from "./kernel/degradation";
+import type {
+  RuntimeAgentContext,
+  RuntimeAssemblyContext,
+  RuntimeAgentPlanningContext,
+} from "./runtime-agent-context";
+
+export interface RuntimeProfileContribution {
+  readonly model: string;
+  readonly thinking: ThinkingEffort;
+  readonly systemPrompt?: string;
+  readonly executionLevel: ExecutionLevel;
+}
+
+export interface RuntimeSkillContribution {
+  readonly name: string;
+  readonly description: string;
+  readonly source: SkillSource;
+  readonly script?: Partial<RuntimeSkillScriptPolicy>;
+}
+
+export interface RuntimeExtensionContribution {
+  readonly name: string;
+  readonly extension: RuntimeExtensionConfig;
+}
+
+export interface RuntimeToolSurfacePolicy {
+  readonly denyPolicy?: RuntimeDenyPolicy;
+  readonly allowsTool?: (name: string) => boolean;
+  readonly allowsExtension?: (extension: RuntimeExtensionConfig) => boolean;
+}
+
+export type { RuntimeAgentContext, RuntimeAssemblyContext } from "./runtime-agent-context";
+
+export interface GateToolRequest {
+  readonly toolCallId: string;
+  readonly toolName: string;
+  readonly input: unknown;
+  readonly requiredExecutionLevel: ExecutionLevel;
+  readonly signal: AbortSignal;
+}
+
+export type {
+  PlatformToolContext,
+  PlatformToolRegistry,
+  PlatformToolSpec,
+  RuntimeToolBindings,
+  ToolAssemblyResult,
+  ToolContext,
+  ToolRegistry,
+  ToolSpec,
+} from "./tool-registry";
+export {
+  emptyPlatformToolRegistry,
+  emptyToolRegistry,
+  mergeToolRegistries,
+  normalizeToolAssembly,
+  toolRegistryFromPiCandidates,
+} from "./tool-registry";
+
+export interface ResolvedConnectors {
+  readonly servers: readonly RuntimeMcpServer[];
+  readonly gateway?: RuntimeGatewayPort;
+  readonly degradations: readonly RuntimeDegradation[];
+}
+
+export interface ResolvedResources {
+  readonly settings: RuntimeSettings;
+  readonly provider: RuntimeProviderPort;
+  readonly platform: RuntimePlatformPort;
+  readonly skills: readonly RuntimeSkillContribution[];
+  readonly extensions: readonly RuntimeExtensionContribution[];
+  readonly connectors: ResolvedConnectors;
+  readonly degradations?: readonly RuntimeDegradation[];
+}
+
+export interface ProfileOverrides {
+  readonly systemPrompt?: string;
+  readonly executionLevel?: ExecutionLevel;
+}
+
+export interface ApprovalHookInput {
+  readonly submissionId: string;
+  readonly approvalExecutionId: string;
+}
+
+export interface SubmissionTerminalHookInput {
+  readonly submissionId: string;
+  readonly status: "completed" | "aborted" | "skipped" | "error";
+  readonly error?: string;
+  readonly resultMessageId?: string;
+}
+
+export interface RuntimeToolSettlementEvent {
+  readonly eventId: string;
+  readonly submissionId: string;
+  readonly toolCallId: string;
+  readonly toolName: string;
+  readonly status: "success" | "error";
+}
+
+export interface RuntimeAgentHooks<
+  Env extends Cloudflare.Env = Cloudflare.Env,
+  Config = unknown,
+  Command = never,
+  Change = never,
+> {
+  readonly beforeCommit?: ReadonlyArray<
+    (
+      ctx: RuntimeAssemblyContext<Env, Command, Change>,
+      config: Config,
+    ) => Promise<void>
+  >;
+
+  readonly onTurnEnd?: (
+    ctx: RuntimeAssemblyContext<Env, Command, Change>,
+    messages: readonly RuntimeTurnMessage[],
+  ) => Promise<void>;
+  readonly onModelUsage?: (event: RuntimeModelUsageEvent) => Promise<void>;
+  readonly onToolStart?: (event: RuntimeToolStartEvent) => Promise<void>;
+  readonly onToolSettled?: (event: RuntimeToolSettlementEvent) => Promise<void>;
+  readonly onApproval?: (input: ApprovalHookInput) => Promise<void>;
+  readonly onActivityChanged?: (
+    projection: RuntimeActivityProjection,
+  ) => Promise<void>;
+  readonly onSubmissionTerminal?: (
+    input: SubmissionTerminalHookInput,
+  ) => Promise<void>;
+
+  readonly gateTool?: (request: GateToolRequest) => Promise<void>;
+
+  readonly profileOverrides?: (
+    ctx: RuntimeAssemblyContext<Env, Command, Change>,
+    config: Config,
+  ) => ProfileOverrides | Promise<ProfileOverrides>;
+}
+
+export interface RuntimeSettings {
+  readonly profile: RuntimeProfileContribution;
+  readonly memoryProfile: RuntimeMemoryProfile;
+  readonly toolPolicy?: RuntimeToolSurfacePolicy;
+  readonly enabledSubagents: readonly string[];
+}
+
+export interface AssembleRuntimeSnapshotInput<
+  Env extends Cloudflare.Env,
+  Config,
+  Command = never,
+  Change = never,
+> {
+  readonly ctx: RuntimeAgentPlanningContext<Env, Command, Change>;
+  readonly config: Config;
+  readonly tools: import("./tool-registry").ToolAssemblyResult;
+  readonly resources: ResolvedResources;
+  readonly hooks?: RuntimeAgentHooks<Env, Config, Command, Change>;
+}