@botbotgo/agent-harness 0.0.309 → 0.0.311

package/dist/contracts/runtime-scheduling.d.ts

@@ -0,0 +1,146 @@
+import type { CompiledAgentBinding, CompiledModel, CompiledTool, ParsedAgentObject, ParsedToolObject } from "./workspace.js";
+import type { HarnessEventListener } from "./runtime-observability.js";
+import type { RuntimeGovernanceBundle } from "./runtime-observability.js";
+export type RuntimeToolResolver = (toolIds: string[], binding?: CompiledAgentBinding) => unknown[];
+export type RuntimeModelResolver = (modelId: string) => unknown;
+export type RuntimeEmbeddingModelResolver = (embeddingModelId: string) => unknown;
+export type RuntimeVectorStoreResolver = (vectorStoreId: string) => unknown;
+export type RuntimeMiddlewareResolver = (binding: CompiledAgentBinding) => unknown[];
+export type RuntimeDeclaredMiddlewareResolver = (input: {
+    kind: string;
+    config: Record<string, unknown>;
+    binding?: CompiledAgentBinding;
+    resolveModel: (model: CompiledModel) => Promise<unknown>;
+}) => unknown | unknown[] | null | undefined | Promise<unknown | unknown[] | null | undefined>;
+export type RuntimeCheckpointerResolver = (binding: CompiledAgentBinding) => unknown;
+export type RuntimeStoreResolver = (binding: CompiledAgentBinding) => unknown;
+export type RuntimeBackendResolver = (binding: CompiledAgentBinding) => unknown;
+export type RuntimeScheduleDefinition = {
+    type: "cron";
+    expression: string;
+} | {
+    type: "interval";
+    everyMinutes: number;
+} | {
+    type: "daily";
+    time: string;
+} | {
+    type: "weekly";
+    time: string;
+    days: string[];
+};
+export type RuntimeScheduleStatus = "active" | "missing";
+export type RuntimeScheduleSource = "crontab" | "schtasks";
+export type RuntimeScheduleRecord = {
+    scheduleId: string;
+    name: string;
+    instruction: string;
+    agentId?: string;
+    schedule: RuntimeScheduleDefinition;
+    source: RuntimeScheduleSource;
+    platform: NodeJS.Platform;
+    status: RuntimeScheduleStatus;
+    systemId: string;
+    createdAt: string;
+    updatedAt: string;
+    metadata?: Record<string, unknown>;
+};
+export type RuntimeScheduleListFilter = {
+    scheduleId?: string;
+    name?: string;
+    agentId?: string;
+    source?: RuntimeScheduleSource;
+    status?: RuntimeScheduleStatus;
+    query?: string;
+};
+export type RuntimeScheduleManageInput = {
+    operation?: "create" | "list" | "get" | "update" | "delete";
+    scheduleId?: string;
+    name?: string;
+    instruction?: string;
+    agentId?: string;
+    schedule?: RuntimeScheduleDefinition;
+    metadata?: Record<string, unknown>;
+    filters?: RuntimeScheduleListFilter;
+};
+export type RuntimeScheduleManageResult = {
+    ok: true;
+    operation: "create" | "get" | "update";
+    schedule: RuntimeScheduleRecord;
+} | {
+    ok: true;
+    operation: "list";
+    items: RuntimeScheduleRecord[];
+    total: number;
+} | {
+    ok: true;
+    operation: "delete";
+    scheduleId: string;
+};
+export type RuntimeScheduleManager = {
+    manageSchedule(input: RuntimeScheduleManageInput): Promise<RuntimeScheduleManageResult>;
+    getSchedule(scheduleId: string): Promise<RuntimeScheduleRecord | null>;
+};
+export type RuntimeAdapterOptions = {
+    toolResolver?: RuntimeToolResolver;
+    modelResolver?: RuntimeModelResolver;
+    embeddingModelResolver?: RuntimeEmbeddingModelResolver;
+    vectorStoreResolver?: RuntimeVectorStoreResolver;
+    middlewareResolver?: RuntimeMiddlewareResolver;
+    declaredMiddlewareResolver?: RuntimeDeclaredMiddlewareResolver;
+    checkpointerResolver?: RuntimeCheckpointerResolver;
+    storeResolver?: RuntimeStoreResolver;
+    backendResolver?: RuntimeBackendResolver;
+    scheduleManager?: RuntimeScheduleManager;
+    functionToolContextResolver?: (input: {
+        binding?: CompiledAgentBinding;
+        sessionId?: string;
+        requestId?: string;
+    }) => Record<string, unknown> | undefined;
+    deepAgentUpstreamSubstrateMode?: "full" | "minimal";
+};
+export type ToolKindAdapter = {
+    type: string;
+    validate: (tool: ParsedToolObject, tools: Map<string, ParsedToolObject>) => void;
+    compile: (tool: ParsedToolObject, tools: Map<string, ParsedToolObject>) => CompiledTool[];
+};
+export type SkillSourceResolver = {
+    kind: string;
+    resolve: (input: {
+        workspaceRoot: string;
+        skill: {
+            sourcePathRef: string;
+        };
+        packagingRoots: string[];
+    }) => string[];
+};
+export type SkillInheritancePolicy = {
+    kind: string;
+    apply: (input: {
+        agent: ParsedAgentObject;
+        ownSkills: string[];
+        parentSkills: string[];
+    }) => string[];
+};
+export type SkillPackagingConvention = {
+    kind: string;
+    resolve: (input: {
+        workspaceRoot: string;
+        skill: {
+            sourcePathRef: string;
+        };
+    }) => string[];
+};
+export type PolicyDecision = {
+    allowed: boolean;
+    reasons: string[];
+    bundles?: RuntimeGovernanceBundle[];
+};
+export type PolicyEvaluator = {
+    kind: string;
+    evaluate: (binding: CompiledAgentBinding) => PolicyDecision | null;
+};
+export type EventSubscriber = {
+    kind: string;
+    onEvent: HarnessEventListener;
+};

package/dist/contracts/runtime-scheduling.js

@@ -0,0 +1 @@
+export {};