agent-runtime-types 0.1.0

package/dist/discovery.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Discovery response types for GET /v1/capabilities/manifest.
+ *
+ * The discovery endpoint returns only capabilities the requesting Operator
+ * is authorized to use (policy-filtered). Operator uses this to build
+ * its tool catalog dynamically at startup.
+ */
+import type { ManifestObjectSchema } from "./manifest.js";
+/** A single discovered capability, ready for tool generation. */
+export type DiscoveredCapability = {
+    /** Dotted capability ID (e.g. "email.list_inbox"). */
+    id: string;
+    /** Tool name for the model (e.g. "email_list_inbox"). Derived from id. */
+    toolName: string;
+    /** Display label. */
+    label: string;
+    /** Model-facing description. */
+    description: string;
+    /** Parameter schema. */
+    inputSchema: ManifestObjectSchema;
+    /** Whether this action requires approval. */
+    requiresApproval: boolean;
+};
+/** GET /v1/capabilities/manifest response shape. */
+export type DiscoveryResponse = {
+    /** All capabilities this Operator is authorized to use. */
+    capabilities: readonly DiscoveredCapability[];
+    /** Broker protocol version for forward compatibility. */
+    protocolVersion: string;
+};
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D,iEAAiE;AACjE,MAAM,MAAM,oBAAoB,GAAG;IACjC,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,WAAW,EAAE,oBAAoB,CAAC;IAClC,6CAA6C;IAC7C,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,oDAAoD;AACpD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,2DAA2D;IAC3D,YAAY,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC9C,yDAAyD;IACzD,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC"}

package/dist/discovery.js

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

package/dist/discovery.js.map

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

package/dist/envelope.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Typed request/response envelopes for broker communication.
+ *
+ * These are the wire-format types for POST /v1/capabilities/invoke.
+ * Backward-compatible with the existing types in broker-capability-tool.ts.
+ */
+import type { BrokerStatus, BrokerErrorCode } from "./status.js";
+/** Typed broker request envelope. Sent by Operator to the broker. */
+export type BrokerCapabilityRequest = {
+    /** Dotted capability ID, e.g. "email.list_inbox". */
+    capability: string;
+    /** Parameters validated against the manifest schema. */
+    params: Record<string, unknown>;
+    /** Unique correlation ID for cross-service tracing. */
+    correlationId: string;
+    /** Operator session key (optional, for audit). */
+    sessionKey?: string;
+    /** Operator agent ID (optional, for policy scoping). */
+    agentId?: string;
+};
+/** Typed broker response envelope. Returned by broker on invoke. */
+export type BrokerCapabilityResponse = {
+    /** Coarse outcome. */
+    status: BrokerStatus;
+    /** Present when status is "ok". Adapter-specific result data. */
+    data?: unknown;
+    /** Human-readable error message. Present on "denied" or "error". */
+    error?: string;
+    /** Machine-readable error code for programmatic handling. */
+    errorCode?: BrokerErrorCode;
+    /** Echoed correlation ID for tracing. */
+    correlationId: string;
+};
+/** Approval request sent by Operator to broker to resolve a pending action. */
+export type BrokerApprovalRequest = {
+    /** The correlationId of the pending action to approve or deny. */
+    correlationId: string;
+    /** Approval decision. */
+    decision: "approve" | "deny";
+    /** Operator session key (optional, for audit). */
+    sessionKey?: string;
+    /** Operator agent ID (optional, for audit). */
+    agentId?: string;
+};
+/** Summary of a pending approval returned by the broker. */
+export type PendingApprovalSummary = {
+    correlationId: string;
+    capability: string;
+    createdAt: number;
+};
+//# sourceMappingURL=envelope.d.ts.map

package/dist/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEjE,qEAAqE;AACrE,MAAM,MAAM,uBAAuB,GAAG;IACpC,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,oEAAoE;AACpE,MAAM,MAAM,wBAAwB,GAAG;IACrC,sBAAsB;IACtB,MAAM,EAAE,YAAY,CAAC;IACrB,iEAAiE;IACjE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,+EAA+E;AAC/E,MAAM,MAAM,qBAAqB,GAAG;IAClC,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,QAAQ,EAAE,SAAS,GAAG,MAAM,CAAC;IAC7B,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,sBAAsB,GAAG;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC"}

package/dist/envelope.js

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

package/dist/envelope.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @operator/protocol — shared wire-format types for the Operator brokered runtime.
+ *
+ * This package is intentionally minimal: just types and constants for the
+ * protocol between Operator, Broker, and integration services.
+ */
+export type { BrokerStatus, BrokerErrorCode } from "./status.js";
+export { BROKER_STATUSES } from "./status.js";
+export type { BrokerCapabilityRequest, BrokerCapabilityResponse, BrokerApprovalRequest, PendingApprovalSummary, } from "./envelope.js";
+export type { ManifestParamSchema, ManifestStringSchema, ManifestNumberSchema, ManifestBooleanSchema, ManifestEnumSchema, ManifestArraySchema, ManifestObjectSchema, CapabilityActionManifest, CapabilityFamilyManifest, } from "./manifest.js";
+export type { DiscoveredCapability, DiscoveryResponse, } from "./discovery.js";
+export type { LogEntry, LogLevel } from "./log.js";
+export { createLogShipper } from "./log-shipper.js";
+export type { LogShipper, LogShipperConfig } from "./log-shipper.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * @operator/protocol — shared wire-format types for the Operator brokered runtime.
+ *
+ * This package is intentionally minimal: just types and constants for the
+ * protocol between Operator, Broker, and integration services.
+ */
+export { BROKER_STATUSES } from "./status.js";
+export { createLogShipper } from "./log-shipper.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA+B9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/log-shipper.d.ts

@@ -0,0 +1,31 @@
+import type { LogEntry } from "./log.js";
+export type LogShipperConfig = {
+    /** URL of the log collector (e.g., "http://log-collector:4300"). */
+    collectorUrl: string;
+    /** Bearer token for authenticating with the collector. */
+    token: string;
+    /** Max entries to buffer before flushing. Default: 20. */
+    batchSize?: number;
+    /** Max time (ms) to hold entries before flushing. Default: 1000. */
+    flushIntervalMs?: number;
+};
+/**
+ * Fire-and-forget log shipper that batches entries and POSTs to the collector.
+ *
+ * - Non-blocking: never throws, never awaits in the critical path.
+ * - Passive: silently drops entries if the collector is unreachable.
+ * - Batching: accumulates entries and flushes on size or time threshold.
+ *
+ * Usage:
+ *   const shipper = createLogShipper({ collectorUrl, token });
+ *   shipper.ship(entry);        // queue an entry
+ *   await shipper.shutdown();   // flush remaining + stop timer
+ */
+export type LogShipper = {
+    /** Queue a log entry for shipping. */
+    ship(entry: LogEntry): void;
+    /** Flush remaining entries and stop the timer. */
+    shutdown(): Promise<void>;
+};
+export declare function createLogShipper(config: LogShipperConfig): LogShipper;
+//# sourceMappingURL=log-shipper.d.ts.map

package/dist/log-shipper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-shipper.d.ts","sourceRoot":"","sources":["../src/log-shipper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,sCAAsC;IACtC,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAqDrE"}

package/dist/log-shipper.js

@@ -0,0 +1,50 @@
+export function createLogShipper(config) {
+    const batchSize = config.batchSize ?? 20;
+    const flushIntervalMs = config.flushIntervalMs ?? 1000;
+    const endpoint = `${config.collectorUrl}/v1/ingest`;
+    const headers = {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${config.token}`,
+    };
+    let buffer = [];
+    let timer = null;
+    function flush() {
+        if (buffer.length === 0)
+            return;
+        const batch = buffer;
+        buffer = [];
+        // Fire-and-forget: no await, catch all errors silently
+        fetch(endpoint, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(batch),
+            signal: AbortSignal.timeout(5000),
+        }).catch(() => {
+            // Collector unavailable — silently drop. Logs are still on stdout.
+        });
+    }
+    // Start periodic flush timer
+    timer = setInterval(flush, flushIntervalMs);
+    // Allow the process to exit even if the timer is running
+    if (timer && typeof timer === "object" && "unref" in timer) {
+        timer.unref();
+    }
+    return {
+        ship(entry) {
+            buffer.push(entry);
+            if (buffer.length >= batchSize) {
+                flush();
+            }
+        },
+        async shutdown() {
+            if (timer) {
+                clearInterval(timer);
+                timer = null;
+            }
+            flush();
+            // Give the last flush a moment to fire
+            await new Promise((r) => setTimeout(r, 100));
+        },
+    };
+}
+//# sourceMappingURL=log-shipper.js.map

package/dist/log-shipper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-shipper.js","sourceRoot":"","sources":["../src/log-shipper.ts"],"names":[],"mappings":"AAgCA,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;IACzC,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,IAAI,IAAI,CAAC;IACvD,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,YAAY,YAAY,CAAC;IACpD,MAAM,OAAO,GAAG;QACd,cAAc,EAAE,kBAAkB;QAClC,aAAa,EAAE,UAAU,MAAM,CAAC,KAAK,EAAE;KACxC,CAAC;IAEF,IAAI,MAAM,GAAe,EAAE,CAAC;IAC5B,IAAI,KAAK,GAA0C,IAAI,CAAC;IAExD,SAAS,KAAK;QACZ,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC;QACrB,MAAM,GAAG,EAAE,CAAC;QAEZ,uDAAuD;QACvD,KAAK,CAAC,QAAQ,EAAE;YACd,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YAC3B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YACZ,mEAAmE;QACrE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,6BAA6B;IAC7B,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IAC5C,yDAAyD;IACzD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;QAC3D,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;IAED,OAAO;QACL,IAAI,CAAC,KAAe;YAClB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,IAAI,MAAM,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;gBAC/B,KAAK,EAAE,CAAC;YACV,CAAC;QACH,CAAC;QAED,KAAK,CAAC,QAAQ;YACZ,IAAI,KAAK,EAAE,CAAC;gBACV,aAAa,CAAC,KAAK,CAAC,CAAC;gBACrB,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;YACD,KAAK,EAAE,CAAC;YACR,uCAAuC;YACvC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC/C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/log.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Shared structured log types for the Operator brokered runtime.
+ *
+ * All services emit LogEntry objects as single-line JSON to stdout.
+ * The log collector ingests these for correlated cross-service tracing.
+ */
+/** Severity level for a log entry. */
+export type LogLevel = "info" | "warn" | "error";
+/** Base structured log entry emitted by every service. */
+export type LogEntry = {
+    /** ISO-8601 timestamp. */
+    ts: string;
+    /** Service name (e.g., "broker", "ai-proxy", "mock-email", "log-collector"). */
+    service: string;
+    /** Event identifier (e.g., "request", "denied", "ok", "startup"). */
+    event: string;
+    /** Severity — defaults to "info" if omitted. */
+    level?: LogLevel;
+    /** Cross-service correlation ID for request tracing. */
+    correlationId?: string;
+    /** Request duration in milliseconds (for timed events). */
+    durationMs?: number;
+    /** Arbitrary additional fields. */
+    [key: string]: unknown;
+};
+//# sourceMappingURL=log.d.ts.map

package/dist/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sCAAsC;AACtC,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEjD,0DAA0D;AAC1D,MAAM,MAAM,QAAQ,GAAG;IACrB,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC"}

package/dist/log.js

@@ -0,0 +1,8 @@
+/**
+ * Shared structured log types for the Operator brokered runtime.
+ *
+ * All services emit LogEntry objects as single-line JSON to stdout.
+ * The log collector ingests these for correlated cross-service tracing.
+ */
+export {};
+//# sourceMappingURL=log.js.map

package/dist/log.js.map

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

package/dist/manifest.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Capability manifest schema types.
+ *
+ * These define the format of broker-owned manifest files (one per integration).
+ * The manifest is the single source of truth: broker validation and Operator
+ * tool schemas are both derived from it.
+ *
+ * Parameter types are a deliberately constrained subset of JSON Schema —
+ * no $ref, no allOf/anyOf/oneOf, no patternProperties. This keeps validation
+ * and tool-schema generation simple and auditable.
+ */
+export type ManifestStringSchema = {
+    type: "string";
+    description?: string;
+    minLength?: number;
+    maxLength?: number;
+    /** Regex pattern. Broker validates; Operator does not enforce. */
+    pattern?: string;
+};
+export type ManifestNumberSchema = {
+    type: "number";
+    description?: string;
+    minimum?: number;
+    maximum?: number;
+    /** If true, value must be an integer. */
+    integer?: boolean;
+};
+export type ManifestBooleanSchema = {
+    type: "boolean";
+    description?: string;
+};
+export type ManifestEnumSchema = {
+    type: "enum";
+    values: readonly string[];
+    description?: string;
+};
+export type ManifestArraySchema = {
+    type: "array";
+    items: ManifestParamSchema;
+    description?: string;
+    minItems?: number;
+    maxItems?: number;
+};
+export type ManifestObjectSchema = {
+    type: "object";
+    properties: Record<string, ManifestParamSchema>;
+    required?: readonly string[];
+    description?: string;
+    /** Reject unknown properties. Default: true (fail-closed). */
+    additionalProperties?: false;
+};
+/**
+ * Closed union of all supported parameter types.
+ * Adding a new type here requires updating both the broker validator
+ * and the Operator's manifestSchemaToTypeBox converter.
+ */
+export type ManifestParamSchema = ManifestStringSchema | ManifestNumberSchema | ManifestBooleanSchema | ManifestEnumSchema | ManifestArraySchema | ManifestObjectSchema;
+/** A single capability action within a family. */
+export type CapabilityActionManifest = {
+    /** Dotted action ID, e.g. "email.list_inbox". Must be globally unique. */
+    id: string;
+    /** Human-readable name for display, e.g. "List Inbox". */
+    label: string;
+    /** Description shown to the model. */
+    description: string;
+    /** Parameter schema. Top level is always an object. */
+    inputSchema: ManifestObjectSchema;
+    /** Whether this action requires approval before execution. */
+    requiresApproval?: boolean;
+    /** Whether this action is read-only (informational for policy). */
+    readOnly?: boolean;
+};
+/** A capability family manifest. One per integration (e.g., email, calendar). */
+export type CapabilityFamilyManifest = {
+    /** Family ID, e.g. "email". */
+    family: string;
+    /** Semver version of this manifest. */
+    version: string;
+    /** Human-readable family description. */
+    description: string;
+    /** All actions in this family. */
+    actions: readonly CapabilityActionManifest[];
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,mBAAmB,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,oBAAoB,CAAC,EAAE,KAAK,CAAC;CAC9B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B,oBAAoB,GACpB,oBAAoB,GACpB,qBAAqB,GACrB,kBAAkB,GAClB,mBAAmB,GACnB,oBAAoB,CAAC;AAMzB,kDAAkD;AAClD,MAAM,MAAM,wBAAwB,GAAG;IACrC,0EAA0E;IAC1E,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,WAAW,EAAE,oBAAoB,CAAC;IAClC,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,iFAAiF;AACjF,MAAM,MAAM,wBAAwB,GAAG;IACrC,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,OAAO,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC9C,CAAC"}

package/dist/manifest.js

@@ -0,0 +1,13 @@
+/**
+ * Capability manifest schema types.
+ *
+ * These define the format of broker-owned manifest files (one per integration).
+ * The manifest is the single source of truth: broker validation and Operator
+ * tool schemas are both derived from it.
+ *
+ * Parameter types are a deliberately constrained subset of JSON Schema —
+ * no $ref, no allOf/anyOf/oneOf, no patternProperties. This keeps validation
+ * and tool-schema generation simple and auditable.
+ */
+export {};
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/status.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Broker response statuses and structured error codes.
+ *
+ * These types define the outcome space for every broker interaction.
+ * Status is the coarse result; error code is the machine-readable reason.
+ */
+/** Exhaustive broker response statuses. */
+export type BrokerStatus = "ok" | "denied" | "needs_approval" | "error";
+/** All valid status values as a frozen set for runtime validation. */
+export declare const BROKER_STATUSES: ReadonlySet<BrokerStatus>;
+/**
+ * Structured error codes for programmatic handling and observability.
+ * Never leak internal details — these are safe to return to Operator.
+ */
+export type BrokerErrorCode = "unknown_capability" | "invalid_params" | "policy_denied" | "adapter_unavailable" | "adapter_error" | "auth_failed" | "rate_limited" | "payload_too_large" | "internal_error" | "approval_not_found" | "approval_expired" | "approval_already_resolved";
+//# sourceMappingURL=status.d.ts.map

package/dist/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,2CAA2C;AAC3C,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,QAAQ,GAAG,gBAAgB,GAAG,OAAO,CAAC;AAExE,sEAAsE;AACtE,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,YAAY,CAKpD,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB,oBAAoB,GACpB,gBAAgB,GAChB,eAAe,GACf,qBAAqB,GACrB,eAAe,GACf,aAAa,GACb,cAAc,GACd,mBAAmB,GACnB,gBAAgB,GAChB,oBAAoB,GACpB,kBAAkB,GAClB,2BAA2B,CAAC"}

package/dist/status.js

@@ -0,0 +1,14 @@
+/**
+ * Broker response statuses and structured error codes.
+ *
+ * These types define the outcome space for every broker interaction.
+ * Status is the coarse result; error code is the machine-readable reason.
+ */
+/** All valid status values as a frozen set for runtime validation. */
+export const BROKER_STATUSES = new Set([
+    "ok",
+    "denied",
+    "needs_approval",
+    "error",
+]);
+//# sourceMappingURL=status.js.map

package/dist/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,sEAAsE;AACtE,MAAM,CAAC,MAAM,eAAe,GAA8B,IAAI,GAAG,CAAC;IAChE,IAAI;IACJ,QAAQ;IACR,gBAAgB;IAChB,OAAO;CACR,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "agent-runtime-types",
+  "version": "0.1.0",
+  "description": "Shared wire-format types for the Operator brokered runtime",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.7.0"
+  }
+}