@rivus/agent 0.13.2 → 0.14.0

package/dist/{rivus-plugin.d.ts → chunks/api2.d.ts}

@@ -1,66 +1,37 @@
-import { c as MemoryScope, t as AgentMemoryAuthority } from "./agent-memory.js";
+import { d as MemoryScope, o as AgentMemoryAuthority } from "./api.js";
+import { Effect } from "effect";
 
-//#region src/domain/automation-presentation.d.ts
-declare const AUTOMATION_PRESENTATION_SCHEMA_VERSION: 1;
-type AutomationPresentationKind = "daily-ai" | "generic" | "industry" | "news" | "subscriptions";
-interface AutomationPresentationSource {
-  readonly label: string;
-  readonly url: string;
-}
-interface AutomationPresentationItem {
-  readonly headline: string;
-  readonly note?: string;
-  readonly sources: ReadonlyArray<AutomationPresentationSource>;
+//#region src/modules/agent-catalog/domain/runtime-tool/rivus-runtime-tool.d.ts
+declare const RIVUS_RUNTIME_TOOL_IDS: readonly ["read", "bash", "edit", "write", "grep", "find", "ls"];
+type RivusRuntimeToolId = (typeof RIVUS_RUNTIME_TOOL_IDS)[number];
+interface RivusRuntimeToolGrantSet {
+  readonly revision: string;
+  readonly toolIds: ReadonlyArray<RivusRuntimeToolId>;
 }
-interface AutomationPresentationSection {
+declare function isRivusRuntimeToolId(value: string): value is RivusRuntimeToolId;
+//#endregion
+//#region src/modules/agent-catalog/domain/skill/rivus-skill.d.ts
+interface RivusSkillDescriptor {
   readonly id: string;
-  readonly items: ReadonlyArray<AutomationPresentationItem>;
-  readonly title: string;
-}
-interface AutomationPresentation {
-  readonly footnote?: string;
-  readonly kind?: AutomationPresentationKind;
-  readonly meta: ReadonlyArray<string>;
-  readonly schemaVersion: typeof AUTOMATION_PRESENTATION_SCHEMA_VERSION;
-  readonly sections: ReadonlyArray<AutomationPresentationSection>;
-  readonly summary?: string;
+  readonly version: string;
+  readonly digest: string;
   readonly title: string;
+  readonly content: string;
 }
-interface AutomationPresentationInput {
-  readonly footnote?: string;
-  readonly kind?: AutomationPresentationKind;
-  readonly meta?: ReadonlyArray<string>;
-  readonly sections: ReadonlyArray<{
-    readonly id: string;
-    readonly items: ReadonlyArray<{
-      readonly headline: string;
-      readonly note?: string;
-      readonly sources?: ReadonlyArray<AutomationPresentationSource>;
-    }>;
-    readonly title: string;
-  }>;
-  readonly summary?: string;
-  readonly title: string;
+interface RegisteredRivusSkill extends RivusSkillDescriptor {
+  readonly pluginId: string;
 }
-declare class InvalidAutomationPresentation extends Error {
-  readonly name = "InvalidAutomationPresentation";
+interface RivusSkillGrantSet {
+  readonly skillIds: ReadonlyArray<string>;
+  readonly revision: string;
 }
-declare function createAutomationPresentation(input: AutomationPresentationInput): AutomationPresentation;
-declare function readAutomationPresentation(value: unknown): AutomationPresentation;
 //#endregion
-//#region src/domain/rivus-plugin.d.ts
-declare const RIVUS_PLUGIN_API_VERSION = "1";
+//#region src/modules/agent-catalog/domain/tool/rivus-tool.d.ts
 type RivusToolRisk = "observe" | "mutate" | "irreversible" | "host-control";
 type RivusToolIdempotency = "none" | "supported" | "required";
-declare function requiresToolApproval(risk: RivusToolRisk): boolean;
 declare class RivusToolInputRejected extends Error {
   readonly name: string;
 }
-interface RivusPluginManifest {
-  readonly apiVersion: string;
-  readonly id: string;
-  readonly version: string;
-}
 interface RivusToolExecutor {
   execute(input: unknown, context: RivusToolExecutionContext): unknown;
 }
@@ -101,31 +72,25 @@ interface RivusToolDescriptor {
 interface RivusHostToolDescriptor extends RivusToolDescriptor {
   readonly replayCompleted?: (input: unknown, completedResult: unknown, context: RivusToolExecutionContext) => unknown;
 }
-interface RivusSkillDescriptor {
+interface RegisteredRivusTool extends RivusToolDescriptor {
+  readonly pluginId: string;
+}
+interface RivusResolvedToolDescriptor {
   readonly id: string;
   readonly version: string;
   readonly digest: string;
-  readonly title: string;
-  readonly content: string;
-}
-interface RivusAutomationTemplate {
-  readonly id: string;
-  readonly profileId: string;
-  readonly requestedSkillIds: ReadonlyArray<string>;
-  readonly requestedToolIds: ReadonlyArray<string>;
-  readonly createInput: (tick: RivusAutomationTickContext) => RivusAutomationInput;
-  readonly createPresentation?: (output: RivusAutomationOutput) => AutomationPresentation;
-}
-interface RivusAutomationTickContext {
-  readonly occurrence: string;
-}
-interface RivusAutomationInput {
-  readonly text: string;
+  readonly description: string;
+  readonly inputSchema: unknown;
+  readonly risk: RivusToolRisk;
+  readonly idempotency: RivusToolIdempotency;
+  readonly pluginId: string;
 }
-interface RivusAutomationOutput {
-  readonly occurrence: string;
-  readonly text: string;
+interface RivusToolGrantSet {
+  readonly toolIds: ReadonlyArray<string>;
+  readonly revision: string;
 }
+//#endregion
+//#region src/modules/agent-catalog/domain/agent/rivus-agent-definition.d.ts
 interface RivusAgentProfile {
   readonly id: string;
   readonly displayName: string;
@@ -140,41 +105,13 @@ interface RivusAgentProfile {
   readonly memory: {
     readonly scopes: ReadonlyArray<MemoryScope>;
   };
-}
-interface RivusPluginRegistry {
-  registerAgentProfile(profile: RivusAgentProfile): void;
-  registerTool(tool: RivusToolDescriptor): void;
-  registerSkill(skill: RivusSkillDescriptor): void;
-  registerAutomation(template: RivusAutomationTemplate): void;
-}
-interface RivusPlugin {
-  readonly manifest: RivusPluginManifest;
-  register(registry: RivusPluginRegistry): void;
-}
-interface RegisteredRivusPlugin extends RivusPluginManifest {}
-interface RegisteredRivusTool extends RivusToolDescriptor {
-  readonly pluginId: string;
-}
-interface RegisteredRivusSkill extends RivusSkillDescriptor {
-  readonly pluginId: string;
-}
-interface RegisteredRivusAutomation extends RivusAutomationTemplate {
-  readonly pluginId: string;
+  readonly runtimeTools?: {
+    readonly allow: ReadonlyArray<RivusRuntimeToolId>;
+  };
 }
 interface RegisteredRivusAgentProfile extends RivusAgentProfile {
   readonly pluginId: string;
 }
-interface RivusPluginCatalogSnapshot {
-  readonly plugins: ReadonlyArray<RegisteredRivusPlugin>;
-  readonly profiles: ReadonlyArray<RegisteredRivusAgentProfile>;
-  readonly tools: ReadonlyArray<RegisteredRivusTool>;
-  readonly skills: ReadonlyArray<RegisteredRivusSkill>;
-  readonly automations: ReadonlyArray<RegisteredRivusAutomation>;
-}
-interface RivusPluginCatalog {
-  registerPlugin(plugin: RivusPlugin): void;
-  snapshot(): RivusPluginCatalogSnapshot;
-}
 interface RivusAgentDeployment {
   readonly agentId: string;
   readonly pluginId: string;
@@ -185,6 +122,9 @@ interface RivusAgentDeployment {
     readonly scopes: ReadonlyArray<MemoryScope>;
     readonly tool: boolean;
   };
+  readonly runtimeTools?: {
+    readonly allow: ReadonlyArray<RivusRuntimeToolId>;
+  };
   readonly skills: {
     readonly allow: ReadonlyArray<string>;
   };
@@ -192,24 +132,6 @@ interface RivusAgentDeployment {
     readonly allow: ReadonlyArray<string>;
   };
 }
-interface RivusResolvedToolDescriptor {
-  readonly id: string;
-  readonly version: string;
-  readonly digest: string;
-  readonly description: string;
-  readonly inputSchema: unknown;
-  readonly risk: RivusToolRisk;
-  readonly idempotency: RivusToolIdempotency;
-  readonly pluginId: string;
-}
-interface RivusToolGrantSet {
-  readonly toolIds: ReadonlyArray<string>;
-  readonly revision: string;
-}
-interface RivusSkillGrantSet {
-  readonly skillIds: ReadonlyArray<string>;
-  readonly revision: string;
-}
 interface ResolvedRivusAgentDefinition {
   readonly agentId: string;
   readonly pluginId: string;
@@ -224,13 +146,242 @@ interface ResolvedRivusAgentDefinition {
     readonly scopes: ReadonlyArray<MemoryScope>;
     readonly tool: boolean;
   };
+  readonly runtimeToolGrantSet: RivusRuntimeToolGrantSet;
   readonly skillGrantSet: RivusSkillGrantSet;
   readonly skills: ReadonlyArray<RegisteredRivusSkill>;
   readonly tools: ReadonlyArray<RivusResolvedToolDescriptor>;
   readonly toolGrantSet: RivusToolGrantSet;
 }
+//#endregion
+//#region src/modules/automation/application/outcome/automation-outcome.d.ts
+type AutomationOutcome = {
+  readonly kind: "suppressed";
+} | {
+  readonly kind: "report" | "alert";
+  readonly body: string;
+  readonly target: string;
+};
+interface PluginStateRecord {
+  readonly pluginId: string;
+  readonly agentId: string;
+  readonly key: string;
+  readonly value: unknown;
+  readonly revision: number;
+}
+interface PutPluginState {
+  readonly pluginId: string;
+  readonly agentId: string;
+  readonly key: string;
+  readonly value: unknown;
+  readonly expectedRevision: number;
+}
+type DeliveryJobStatus = "pending" | "delivered" | "reconciliation-required";
+interface DeliveryJob {
+  readonly id: string;
+  readonly tickId: string;
+  readonly kind: "report" | "alert";
+  readonly body: string;
+  readonly target: string;
+  readonly status: DeliveryJobStatus;
+  readonly receiptId?: string;
+}
+type DeliveryAttemptResult = {
+  readonly kind: "delivered";
+  readonly providerMessageId: string;
+} | {
+  readonly kind: "uncertain";
+};
+interface CommittedAutomationOutcome {
+  readonly state: PluginStateRecord;
+  readonly job?: DeliveryJob;
+}
+//#endregion
+//#region src/modules/automation/domain/mandate/automation-mandate.d.ts
+interface AutomationBinding {
+  readonly agentId: string;
+  readonly bindingId: string;
+  readonly delivery: AutomationDeliveryBinding;
+  readonly schedule: string;
+  readonly servicePrincipalId: string;
+  readonly skillGrantRevision: string;
+  readonly skillIds: ReadonlyArray<string>;
+  readonly templateId: string;
+  readonly timeZone: string;
+  readonly toolIds: ReadonlyArray<string>;
+}
+interface AutomationDeliveryBinding {
+  readonly endpointId: string;
+  readonly targetKey: string;
+  readonly targetType: "chat_id" | "open_id" | "user_id" | "union_id" | "email";
+}
+interface AutomationMandate extends AutomationBinding {
+  readonly id: string;
+  readonly active: boolean;
+}
+interface AutomationTick {
+  readonly tickId: string;
+  readonly mandateId: string;
+  readonly occurrence: string;
+  readonly claimedBy: string;
+}
+interface AutomationMandateStore {
+  activate(binding: AutomationBinding): AutomationMandate;
+  revoke(id: string): void;
+  claim(id: string, occurrence: string, workerId: string): AutomationTick;
+}
+declare class AutomationMandateError extends Error {
+  readonly name = "AutomationMandateError";
+}
+//#endregion
+//#region src/modules/automation/domain/presentation/automation-presentation.d.ts
+declare const AUTOMATION_PRESENTATION_SCHEMA_VERSION: 1;
+type AutomationPresentationKind = "daily-ai" | "generic" | "industry" | "news" | "subscriptions";
+interface AutomationPresentationSource {
+  readonly label: string;
+  readonly url: string;
+}
+interface AutomationPresentationItem {
+  readonly headline: string;
+  readonly note?: string;
+  readonly sources: ReadonlyArray<AutomationPresentationSource>;
+}
+interface AutomationPresentationSection {
+  readonly id: string;
+  readonly items: ReadonlyArray<AutomationPresentationItem>;
+  readonly title: string;
+}
+interface AutomationPresentation {
+  readonly footnote?: string;
+  readonly kind?: AutomationPresentationKind;
+  readonly meta: ReadonlyArray<string>;
+  readonly schemaVersion: typeof AUTOMATION_PRESENTATION_SCHEMA_VERSION;
+  readonly sections: ReadonlyArray<AutomationPresentationSection>;
+  readonly summary?: string;
+  readonly title: string;
+}
+interface AutomationPresentationInput {
+  readonly footnote?: string;
+  readonly kind?: AutomationPresentationKind;
+  readonly meta?: ReadonlyArray<string>;
+  readonly sections: ReadonlyArray<{
+    readonly id: string;
+    readonly items: ReadonlyArray<{
+      readonly headline: string;
+      readonly note?: string;
+      readonly sources?: ReadonlyArray<AutomationPresentationSource>;
+    }>;
+    readonly title: string;
+  }>;
+  readonly summary?: string;
+  readonly title: string;
+}
+declare class InvalidAutomationPresentation extends Error {
+  readonly name = "InvalidAutomationPresentation";
+}
+declare function createAutomationPresentation(input: AutomationPresentationInput): AutomationPresentation;
+declare function readAutomationPresentation(value: unknown): AutomationPresentation;
+//#endregion
+//#region src/modules/automation/domain/tick/automation-tick.d.ts
+type AutomationTickStatus = "running" | "failed" | "generated" | "suppressed" | "delivered";
+interface AutomationTickRecord {
+  readonly automationId: string;
+  readonly body?: string;
+  readonly error?: string;
+  readonly occurrence: string;
+  readonly mandateId: string;
+  readonly providerMessageId?: string;
+  readonly presentation?: AutomationPresentation;
+  readonly revision: number;
+  readonly runId?: string;
+  readonly suppressionReason?: string;
+  readonly status: AutomationTickStatus;
+  readonly tickId: string;
+}
+//#endregion
+//#region src/modules/automation/application/scheduling/automation-scheduler.d.ts
+declare const AUTOMATION_SUPPRESSION_PREFIX = "RIVUS_AUTOMATION_SUPPRESSED:";
+interface ScheduledAutomationRunInput {
+  readonly occurrence: string;
+  readonly sessionKey: string;
+  readonly text: string;
+  readonly tickId: string;
+}
+interface ScheduledAutomationRunResult {
+  readonly body?: string;
+  readonly presentation?: AutomationPresentation;
+  readonly runId: string;
+  readonly suppressedReason?: string;
+}
+interface ScheduledAutomationDeliveryInput {
+  readonly body: string;
+  readonly idempotencyKey: string;
+  readonly presentation?: AutomationPresentation;
+}
+//#endregion
+//#region src/modules/automation/domain/schedule/daily-automation-schedule.d.ts
+interface DailyAutomationSchedule {
+  currentOccurrence(now: Date): string | undefined;
+  nextOccurrence(now: Date): Date;
+}
+declare function createDailyAutomationSchedule(expression: string, timeZone: string, now?: Date): DailyAutomationSchedule;
+//#endregion
+//#region src/modules/agent-catalog/domain/automation/rivus-automation-template.d.ts
+interface RivusAutomationTemplate {
+  readonly id: string;
+  readonly profileId: string;
+  readonly requestedSkillIds: ReadonlyArray<string>;
+  readonly requestedToolIds: ReadonlyArray<string>;
+  readonly createInput: (tick: RivusAutomationTickContext) => RivusAutomationInput;
+  readonly createPresentation?: (output: RivusAutomationOutput) => AutomationPresentation;
+}
+interface RivusAutomationTickContext {
+  readonly occurrence: string;
+}
+interface RivusAutomationInput {
+  readonly text: string;
+}
+interface RivusAutomationOutput {
+  readonly occurrence: string;
+  readonly text: string;
+}
+interface RegisteredRivusAutomation extends RivusAutomationTemplate {
+  readonly pluginId: string;
+}
+//#endregion
+//#region src/modules/agent-catalog/domain/plugin/rivus-plugin.d.ts
+declare const RIVUS_PLUGIN_API_VERSION = "1";
+interface RivusPluginManifest {
+  readonly apiVersion: string;
+  readonly id: string;
+  readonly version: string;
+}
+interface RivusPluginRegistry {
+  registerAgentProfile(profile: RivusAgentProfile): void;
+  registerTool(tool: RivusToolDescriptor): void;
+  registerSkill(skill: RivusSkillDescriptor): void;
+  registerAutomation(template: RivusAutomationTemplate): void;
+}
+interface RivusPlugin {
+  readonly manifest: RivusPluginManifest;
+  register(registry: RivusPluginRegistry): void;
+}
+interface RegisteredRivusPlugin extends RivusPluginManifest {}
+interface RivusPluginCatalogSnapshot {
+  readonly plugins: ReadonlyArray<RegisteredRivusPlugin>;
+  readonly profiles: ReadonlyArray<RegisteredRivusAgentProfile>;
+  readonly tools: ReadonlyArray<RegisteredRivusTool>;
+  readonly skills: ReadonlyArray<RegisteredRivusSkill>;
+  readonly automations: ReadonlyArray<RegisteredRivusAutomation>;
+}
+interface RivusPluginCatalog {
+  registerPlugin(plugin: RivusPlugin): void;
+  snapshot(): RivusPluginCatalogSnapshot;
+}
 declare class InvalidRivusPlugin extends Error {
   readonly name = "InvalidRivusPlugin";
 }
 //#endregion
-export { RivusToolInputRejected as A, InvalidAutomationPresentation as B, RivusSkillGrantSet as C, RivusToolFactoryContext as D, RivusToolExecutor as E, AutomationPresentationInput as F, readAutomationPresentation as H, AutomationPresentationItem as I, AutomationPresentationKind as L, requiresToolApproval as M, AUTOMATION_PRESENTATION_SCHEMA_VERSION as N, RivusToolGrantSet as O, AutomationPresentation as P, AutomationPresentationSection as R, RivusSkillDescriptor as S, RivusToolExecutionContext as T, createAutomationPresentation as V, RivusPluginCatalog as _, RegisteredRivusPlugin as a, RivusPluginRegistry as b, ResolvedRivusAgentDefinition as c, RivusAutomationInput as d, RivusAutomationOutput as f, RivusPlugin as g, RivusHostToolDescriptor as h, RegisteredRivusAutomation as i, RivusToolRisk as j, RivusToolIdempotency as k, RivusAgentDeployment as l, RivusAutomationTickContext as m, RIVUS_PLUGIN_API_VERSION as n, RegisteredRivusSkill as o, RivusAutomationTemplate as p, RegisteredRivusAgentProfile as r, RegisteredRivusTool as s, InvalidRivusPlugin as t, RivusAgentProfile as u, RivusPluginCatalogSnapshot as v, RivusToolDescriptor as w, RivusResolvedToolDescriptor as x, RivusPluginManifest as y, AutomationPresentationSource as z };
+//#region src/modules/agent-catalog/application/catalog/rivus-plugin-catalog.d.ts
+declare function createRivusPluginCatalog(): RivusPluginCatalog;
+//#endregion
+export { RivusToolDescriptor as $, InvalidAutomationPresentation as A, CommittedAutomationOutcome as B, AUTOMATION_PRESENTATION_SCHEMA_VERSION as C, AutomationPresentationKind as D, AutomationPresentationItem as E, AutomationMandate as F, PutPluginState as G, DeliveryJob as H, AutomationMandateError as I, RivusAgentDeployment as J, RegisteredRivusAgentProfile as K, AutomationMandateStore as L, readAutomationPresentation as M, AutomationBinding as N, AutomationPresentationSection as O, AutomationDeliveryBinding as P, RivusResolvedToolDescriptor as Q, AutomationTick as R, AutomationTickStatus as S, AutomationPresentationInput as T, DeliveryJobStatus as U, DeliveryAttemptResult as V, PluginStateRecord as W, RegisteredRivusTool as X, RivusAgentProfile as Y, RivusHostToolDescriptor as Z, AUTOMATION_SUPPRESSION_PREFIX as _, RivusPlugin as a, RivusToolInputRejected as at, ScheduledAutomationRunResult as b, RivusPluginManifest as c, RivusSkillDescriptor as ct, RivusAutomationInput as d, RivusRuntimeToolGrantSet as dt, RivusToolExecutionContext as et, RivusAutomationOutput as f, RivusRuntimeToolId as ft, createDailyAutomationSchedule as g, DailyAutomationSchedule as h, RegisteredRivusPlugin as i, RivusToolIdempotency as it, createAutomationPresentation as j, AutomationPresentationSource as k, RivusPluginRegistry as l, RivusSkillGrantSet as lt, RivusAutomationTickContext as m, InvalidRivusPlugin as n, RivusToolFactoryContext as nt, RivusPluginCatalog as o, RivusToolRisk as ot, RivusAutomationTemplate as p, isRivusRuntimeToolId as pt, ResolvedRivusAgentDefinition as q, RIVUS_PLUGIN_API_VERSION as r, RivusToolGrantSet as rt, RivusPluginCatalogSnapshot as s, RegisteredRivusSkill as st, createRivusPluginCatalog as t, RivusToolExecutor as tt, RegisteredRivusAutomation as u, RIVUS_RUNTIME_TOOL_IDS as ut, ScheduledAutomationDeliveryInput as v, AutomationPresentation as w, AutomationTickRecord as x, ScheduledAutomationRunInput as y, AutomationOutcome as z };