@assemblyline-agents/core 0.1.0

package/dist/manifest-types.d.ts

@@ -0,0 +1,248 @@
+import type { OPENEVE_MANIFEST_SCHEMA_VERSION, AdapterDefinition, AdapterProviderMetadata, AgentDefinition, AutomationDefinition, AutomationTrigger, ApprovalPolicy, CapabilityExecutionMode, CapabilityVisibility, ChannelDefinition, ConnectionDefinition, ConnectionProtocol, ContextPolicy, GatewayDefinition, JsonObject, JsonSchema, ReasoningLevel, SandboxSnapshotPolicy, ScheduleTriggerDefinition } from "./index.js";
+export interface ManifestFile {
+    path: string;
+    role: string;
+    sha256: string;
+    size: number;
+}
+export interface SourceReference {
+    path: string;
+    sha256: string;
+}
+export interface CompiledInstructions {
+    text: string;
+    source: SourceReference;
+}
+export interface CompiledContext {
+    policy: ContextPolicy;
+    source?: SourceReference;
+    usesDefault: boolean;
+}
+export interface CompiledSkill {
+    name: string;
+    instructions: string;
+    allowedTools: string[];
+    frontmatter: Record<string, string | string[] | boolean>;
+    source: SourceReference;
+}
+export interface CompiledTool {
+    name: string;
+    description: string;
+    inputSchema: JsonSchema;
+    outputSchema?: JsonSchema;
+    needsApproval: ApprovalPolicy;
+    defaultEnabled: boolean;
+    visibility: Exclude<CapabilityVisibility, "auto">;
+    execution: Exclude<CapabilityExecutionMode, "auto">;
+    namespace?: string;
+    tags: string[];
+    aliases: string[];
+    hasToModelOutput: boolean;
+    /** True when an authored `disableTool()` file removes this built-in tool. */
+    disabled?: boolean;
+    source: SourceReference;
+}
+/** An authored observe-only hook module compiled into the manifest. */
+export interface CompiledHook {
+    name: string;
+    source: SourceReference;
+}
+export type CompiledCapabilityKind = "tool" | "skill" | "subagent" | "connection" | "builtin" | "namespace";
+export interface CompiledCapability {
+    id: string;
+    kind: CompiledCapabilityKind;
+    name: string;
+    description: string;
+    visibility: Exclude<CapabilityVisibility, "auto">;
+    execution: Exclude<CapabilityExecutionMode, "auto">;
+    namespace?: string;
+    tags: string[];
+    aliases: string[];
+    source?: SourceReference;
+    toolName?: string;
+    skillName?: string;
+    subagentName?: string;
+    connectionName?: string;
+    reveals: string[];
+}
+export interface CompiledChannel {
+    name: string;
+    description?: string;
+    transport: ChannelDefinition["transport"];
+    route?: string;
+    methods: string[];
+    connection?: string;
+    metadata?: JsonObject;
+    requiredEnv: string[];
+    source: SourceReference;
+}
+export interface CompiledSchedule {
+    name: string;
+    description?: string;
+    cron: string;
+    timezone?: string;
+    idempotencyKey: string;
+    message?: string;
+    trigger?: ScheduleTriggerDefinition;
+    enabled: boolean;
+    source: SourceReference;
+}
+export interface CompiledAutomation extends Omit<AutomationDefinition, "enabled"> {
+    name: string;
+    enabled: boolean;
+    source: SourceReference;
+    legacy?: boolean;
+}
+export interface CompiledAutomationHandler {
+    name: string;
+    description?: string;
+    source: SourceReference;
+    legacy?: boolean;
+}
+/** @deprecated Use `CompiledAutomationHandler`. */
+export interface CompiledTriggerHandler {
+    name: string;
+    description?: string;
+    source: SourceReference;
+}
+/** Static host constraints for connections that execute on the OpenEve runtime machine. */
+export interface ConnectionHostRequirements {
+    /** Deployment targets that can place the connection on the intended host. */
+    deployTargets?: string[];
+    /** Node platform names supported by the host executable, for example `darwin`. */
+    platforms?: string[];
+    /** Actionable explanation shown by validation, deployment planning, and runtime checks. */
+    message: string;
+}
+export interface CompiledConnection {
+    name: string;
+    protocol: ConnectionProtocol;
+    transport?: "http" | "stdio" | "relay" | "sandbox";
+    provider: string;
+    description?: string;
+    binding?: AdapterDefinition;
+    url?: string;
+    scopes: string[];
+    capabilities: string[];
+    hostRequirements?: ConnectionHostRequirements;
+    subject: NonNullable<ConnectionDefinition["subject"]>;
+    required: boolean;
+    source: SourceReference;
+}
+export interface CompiledSandbox {
+    name: string;
+    adapter: string;
+    image?: string;
+    workingDirectory?: string;
+    env: string[];
+    snapshot?: SandboxSnapshotPolicy;
+    source: SourceReference;
+}
+export interface CompiledSubagent {
+    name: string;
+    description: string;
+    model: string;
+    reasoning?: ReasoningLevel;
+    outputSchema?: JsonSchema;
+    maxIterations?: number;
+    workspace?: AdapterDefinition;
+    connections: string[];
+    inherits: {
+        skills: string[];
+        tools: string[];
+        context: boolean;
+    };
+    source: SourceReference;
+}
+export interface RouteRegistration {
+    channel: string;
+    route: string;
+    methods: string[];
+}
+export interface ScheduleRegistration {
+    schedule: string;
+    cron: string;
+    timezone?: string;
+    idempotencyKey: string;
+    message?: string;
+    trigger?: ScheduleTriggerDefinition;
+    target?: AutomationDefinition["target"];
+}
+export interface AutomationRegistration {
+    automation: string;
+    trigger: AutomationTrigger;
+    idempotencyKey: string;
+    message?: string;
+    target?: AutomationDefinition["target"];
+    lifecycle?: AutomationDefinition["lifecycle"];
+    metadata?: JsonObject;
+}
+export interface PreflightRequirement {
+    kind: "env" | "database" | "blob" | "sandbox" | "connection" | "migration" | "deploy";
+    name: string;
+    alternatives?: string[];
+    required: boolean;
+    adapter?: string;
+    message: string;
+}
+export interface ValidationIssue {
+    level: "error" | "warning";
+    code: string;
+    message: string;
+    path?: string;
+    hint?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    issues: ValidationIssue[];
+}
+/** Filesystem and host capabilities a deployment must provide to run an artifact. */
+export interface DeploymentRequirements {
+    persistentDirectories: Array<{
+        id: string;
+        path: string;
+        sensitive: boolean;
+    }>;
+    remoteExecution: boolean;
+}
+export interface AgentManifest {
+    schemaVersion: typeof OPENEVE_MANIFEST_SCHEMA_VERSION;
+    manifestVersion: string;
+    generatedAt: string;
+    agentRevision: string;
+    root: string;
+    agent: AgentDefinition;
+    gateway: GatewayDefinition;
+    instructions: CompiledInstructions;
+    context: CompiledContext;
+    files: ManifestFile[];
+    skills: CompiledSkill[];
+    tools: CompiledTool[];
+    capabilities: CompiledCapability[];
+    channels: CompiledChannel[];
+    automations: CompiledAutomation[];
+    automationHandlers: CompiledAutomationHandler[];
+    automationRegistrations: AutomationRegistration[];
+    /** @deprecated Legacy authored schedules, retained for manifest compatibility. */
+    schedules: CompiledSchedule[];
+    /** @deprecated Legacy trigger handlers, retained for manifest compatibility. */
+    triggerHandlers: CompiledTriggerHandler[];
+    connections: CompiledConnection[];
+    sandboxes: CompiledSandbox[];
+    subagents: CompiledSubagent[];
+    /** Observe-only event subscribers from `hooks/`. */
+    hooks?: CompiledHook[];
+    /** Per-run capability resolver from `resolvers.ts`. */
+    resolver?: SourceReference;
+    instrumentation?: SourceReference;
+    routeTable: RouteRegistration[];
+    scheduleRegistrations: ScheduleRegistration[];
+    preflight: PreflightRequirement[];
+    /** Optional hosted-runtime requirements inferred from the selected model/runtime. */
+    deploymentRequirements?: DeploymentRequirements;
+    /** Provider metadata resolved at build time from third-party `openeveProvider` packages. */
+    providerMetadata?: AdapterProviderMetadata[];
+    validation: ValidationResult;
+    packageVersions: Record<string, string>;
+}
+//# sourceMappingURL=manifest-types.d.ts.map

package/dist/manifest-types.d.ts.map

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

package/dist/manifest-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=manifest-types.js.map

package/dist/manifest-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-types.js","sourceRoot":"","sources":["../src/manifest-types.ts"],"names":[],"mappings":""}

package/dist/plugin.d.ts

@@ -0,0 +1,134 @@
+import type { AdapterDefinition, AdapterProviderMetadata } from "./index.js";
+import type { ConnectionApprovalDefinition, ConnectionAuthDefinition, ConnectionDefinition, HeadersDefinition, McpClientConnectionDefinition, McpHttpClientConnectionDefinition, McpRelayClientConnectionDefinition, McpStdioClientConnectionDefinition, OpenAPIConnectionDefinition, OpenAPISpecSource, SandboxCliConnectionDefinition, SandboxCliToolDefinition, ToolFilterDefinition } from "./connection-types.js";
+import type { ConnectionHostRequirements } from "./manifest-types.js";
+/** The small, explicit policy an agent author writes in connections/<name>.ts. */
+export interface ConnectionPluginAccessSelection {
+    read: true;
+    write: false | {
+        approval: "always" | "once" | "never" | ConnectionApprovalDefinition;
+    };
+}
+/** Static metadata shared by the CLI, compiler, and a provider's helper. */
+export interface ConnectionPluginMetadata extends AdapterProviderMetadata {
+    role: "connection";
+    helper: string;
+    protocol: "mcp" | "openapi" | "cli";
+    /** Defaults to Streamable HTTP when omitted by third-party plugin metadata. */
+    transport?: "http" | "stdio" | "relay" | "sandbox";
+    provider: string;
+    description: string;
+    command?: string;
+    defaultUrl?: string;
+    urlEnv?: string;
+    defaultSpec?: string;
+    specEnv?: string;
+    defaultBaseUrl?: string;
+    baseUrlEnv?: string;
+    tokenEnv?: string;
+    tokenRequired?: boolean;
+    /** Send tokenEnv verbatim in this header instead of using Bearer authorization. */
+    tokenHeader?: string;
+    /** Environment variable containing one opaque, device-scoped relay binding. */
+    credentialEnv?: string;
+    scopes?: string[];
+    subject?: NonNullable<ConnectionDefinition["subject"]>;
+    tools?: ToolFilterDefinition;
+    /** Runtime-host restrictions for process-backed or platform-specific plugins. */
+    hostRequirements?: ConnectionHostRequirements;
+    readToolPatterns: string[];
+    writeToolPatterns: string[];
+    skill?: string;
+    skills?: string[];
+}
+export interface PluginModule {
+    connections?: ConnectionPluginMetadata[];
+}
+export interface McpPluginConnectionOptions {
+    url?: string;
+    description?: string;
+    /** Pass false for an intentionally unauthenticated or header-authenticated bridge. */
+    auth?: ConnectionAuthDefinition | false;
+    headers?: HeadersDefinition;
+    tools?: ToolFilterDefinition;
+    access: ConnectionPluginAccessSelection;
+    required?: boolean;
+    subject?: ConnectionDefinition["subject"];
+    metadata?: McpClientConnectionDefinition["metadata"];
+}
+export interface StdioMcpPluginConnectionOptions {
+    command?: string;
+    args?: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    description?: string;
+    tools?: ToolFilterDefinition;
+    access: ConnectionPluginAccessSelection;
+    required?: boolean;
+    subject?: ConnectionDefinition["subject"];
+    metadata?: McpClientConnectionDefinition["metadata"];
+}
+export interface RelayMcpPluginConnectionOptions {
+    url?: string;
+    credentialEnv?: string;
+    timeoutMs?: number;
+    description?: string;
+    tools?: ToolFilterDefinition;
+    access: ConnectionPluginAccessSelection;
+    required?: boolean;
+    subject?: ConnectionDefinition["subject"];
+    metadata?: McpClientConnectionDefinition["metadata"];
+}
+export interface OpenAPIPluginConnectionOptions {
+    spec?: OpenAPISpecSource;
+    baseUrl?: string;
+    description?: string;
+    /** Pass false only when the API is intentionally unauthenticated or uses custom headers. */
+    auth?: ConnectionAuthDefinition | false;
+    headers?: HeadersDefinition;
+    operations?: ToolFilterDefinition;
+    access: ConnectionPluginAccessSelection;
+    required?: boolean;
+    subject?: ConnectionDefinition["subject"];
+    metadata?: OpenAPIConnectionDefinition["metadata"];
+}
+export interface SandboxCliPluginConnectionOptions {
+    command?: string;
+    description?: string;
+    tools: SandboxCliToolDefinition[];
+    access: ConnectionPluginAccessSelection;
+    auth?: ConnectionAuthDefinition;
+    maxOutputChars?: number;
+    required?: boolean;
+    subject?: ConnectionDefinition["subject"];
+    metadata?: SandboxCliConnectionDefinition["metadata"];
+}
+export declare function definePlugin(module: PluginModule): PluginModule;
+/**
+ * Reads `assemblyLinePlugin` (falling back to the legacy `openevePlugin`
+ * name) from a dynamically imported module namespace. Exporting both names
+ * with different values is a packaging error.
+ */
+export declare function pluginModuleFromImport(imported: unknown): PluginModule | undefined;
+/**
+ * Provider packages use this factory instead of implementing transport or
+ * credential plumbing. The developer still owns the provider application,
+ * token/OAuth grant, and any required MCP bridge.
+ */
+export declare function defineMcpPluginConnection(plugin: ConnectionPluginMetadata, options: McpPluginConnectionOptions): McpHttpClientConnectionDefinition;
+export declare function defineStdioMcpPluginConnection(plugin: ConnectionPluginMetadata, options: StdioMcpPluginConnectionOptions & {
+    command: string;
+    args?: string[];
+}): McpStdioClientConnectionDefinition;
+export declare function defineRelayMcpPluginConnection(plugin: ConnectionPluginMetadata, options: RelayMcpPluginConnectionOptions): McpRelayClientConnectionDefinition;
+/** Build a direct HTTP API connection from a provider's reviewed OpenAPI metadata. */
+export declare function defineOpenAPIPluginConnection(plugin: ConnectionPluginMetadata, options: OpenAPIPluginConnectionOptions): OpenAPIConnectionDefinition;
+/**
+ * Build a connection whose reviewed operations run through a provider CLI in
+ * the agent sandbox rather than on the OpenEve gateway host.
+ */
+export declare function defineSandboxCliPluginConnection(plugin: ConnectionPluginMetadata, options: SandboxCliPluginConnectionOptions): SandboxCliConnectionDefinition;
+export declare function connectionPluginMetadata(kind: string): ConnectionPluginMetadata | undefined;
+export declare function connectionPluginMetadataForHelper(helper: string | undefined): ConnectionPluginMetadata | undefined;
+export declare function allConnectionPluginMetadata(): ConnectionPluginMetadata[];
+export declare function connectionPluginBinding(metadata: ConnectionPluginMetadata): AdapterDefinition;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

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