recoder-a2a-sdk 1.0.0 → 1.0.1

package/dist/audit-event-Bhf9-AJV.d.mts

@@ -0,0 +1,123 @@
+import { R as RecoderAgentPlatform } from './types-Bt96SgOS.mjs';
+
+/**
+ * @module audit-event
+ *
+ * Canonical AuditEvent schema for the Recoder A2A control plane.
+ */
+
+/** Current version of the AuditEvent schema. */
+declare const AUDIT_EVENT_VERSION: "1.0.0";
+declare const AuditEventTypeEnum: {
+    readonly TaskSubmitted: "task.submitted";
+    readonly TaskStarted: "task.started";
+    readonly TaskProgress: "task.progress";
+    readonly TaskInputRequired: "task.input_required";
+    readonly TaskCompleted: "task.completed";
+    readonly TaskFailed: "task.failed";
+    readonly TaskCancelled: "task.cancelled";
+    readonly PolicyChecked: "policy.checked";
+    readonly PolicyApproved: "policy.approved";
+    readonly PolicyDenied: "policy.denied";
+    readonly ConnectorAttached: "connector.attached";
+    readonly ConnectorDetached: "connector.detached";
+    readonly ConnectorHealth: "connector.health";
+    readonly ConnectorError: "connector.error";
+    readonly AgentRegistered: "agent.registered";
+    readonly AgentUnregistered: "agent.unregistered";
+    readonly AgentUpdated: "agent.updated";
+    readonly ChannelCreated: "collaboration.channel_created";
+    readonly ThreadCreated: "collaboration.thread_created";
+    readonly MessageSent: "collaboration.message_sent";
+    readonly SystemConfig: "system.config";
+    readonly SystemError: "system.error";
+};
+/** Union of all valid audit event type string values. */
+type AuditEventType = (typeof AuditEventTypeEnum)[keyof typeof AuditEventTypeEnum];
+/** Ordered list of all event types (useful for validation / UI dropdowns). */
+declare const AUDIT_EVENT_TYPES: readonly AuditEventType[];
+declare const AuditActorKindEnum: {
+    readonly Agent: "agent";
+    readonly User: "user";
+    readonly System: "system";
+    readonly Connector: "connector";
+};
+type AuditActorKind = (typeof AuditActorKindEnum)[keyof typeof AuditActorKindEnum];
+interface AuditActor {
+    kind: AuditActorKind;
+    id: string;
+    name?: string;
+    platform?: RecoderAgentPlatform;
+    metadata?: Record<string, unknown>;
+}
+declare const AuditTargetKindEnum: {
+    readonly Task: "task";
+    readonly Agent: "agent";
+    readonly Connector: "connector";
+    readonly Channel: "channel";
+    readonly Thread: "thread";
+    readonly Message: "message";
+    readonly Policy: "policy";
+    readonly Workspace: "workspace";
+    readonly System: "system";
+};
+type AuditTargetKind = (typeof AuditTargetKindEnum)[keyof typeof AuditTargetKindEnum];
+interface AuditTarget {
+    kind: AuditTargetKind;
+    id: string;
+    name?: string;
+    metadata?: Record<string, unknown>;
+}
+interface AuditPolicyContext {
+    action: string;
+    rule: string;
+    approved: boolean;
+    reason: string;
+    agent_id: string;
+    details?: Record<string, unknown>;
+}
+declare const AuditSeverityEnum: {
+    readonly Info: "info";
+    readonly Warning: "warning";
+    readonly Error: "error";
+    readonly Critical: "critical";
+};
+type AuditSeverity = (typeof AuditSeverityEnum)[keyof typeof AuditSeverityEnum];
+interface AuditEvent {
+    schema_version: string;
+    id: string;
+    event_type: AuditEventType;
+    severity?: AuditSeverity;
+    actor: AuditActor;
+    target: AuditTarget;
+    trace_id: string;
+    parent_event_id?: string;
+    workspace_id: string;
+    thread_id?: string;
+    task_id?: string;
+    timestamp: string;
+    duration_ms?: number;
+    policy?: AuditPolicyContext;
+    metadata?: Record<string, unknown>;
+    tags?: string[];
+}
+interface CreateAuditEventInput {
+    id: string;
+    event_type: AuditEventType;
+    actor: AuditActor;
+    target: AuditTarget;
+    trace_id: string;
+    workspace_id: string;
+    thread_id?: string;
+    task_id?: string;
+    parent_event_id?: string;
+    severity?: AuditSeverity;
+    policy?: AuditPolicyContext;
+    metadata?: Record<string, unknown>;
+    tags?: string[];
+    duration_ms?: number;
+    now?: string;
+}
+declare function createAuditEvent(input: CreateAuditEventInput): AuditEvent;
+
+export { AUDIT_EVENT_TYPES as A, type CreateAuditEventInput as C, AUDIT_EVENT_VERSION as a, type AuditActor as b, type AuditActorKind as c, AuditActorKindEnum as d, type AuditEvent as e, type AuditEventType as f, AuditEventTypeEnum as g, type AuditPolicyContext as h, type AuditSeverity as i, AuditSeverityEnum as j, type AuditTarget as k, type AuditTargetKind as l, AuditTargetKindEnum as m, createAuditEvent as n };

package/dist/audit-event-D8PTRp8M.d.ts

@@ -0,0 +1,123 @@
+import { R as RecoderAgentPlatform } from './types-Bt96SgOS.js';
+
+/**
+ * @module audit-event
+ *
+ * Canonical AuditEvent schema for the Recoder A2A control plane.
+ */
+
+/** Current version of the AuditEvent schema. */
+declare const AUDIT_EVENT_VERSION: "1.0.0";
+declare const AuditEventTypeEnum: {
+    readonly TaskSubmitted: "task.submitted";
+    readonly TaskStarted: "task.started";
+    readonly TaskProgress: "task.progress";
+    readonly TaskInputRequired: "task.input_required";
+    readonly TaskCompleted: "task.completed";
+    readonly TaskFailed: "task.failed";
+    readonly TaskCancelled: "task.cancelled";
+    readonly PolicyChecked: "policy.checked";
+    readonly PolicyApproved: "policy.approved";
+    readonly PolicyDenied: "policy.denied";
+    readonly ConnectorAttached: "connector.attached";
+    readonly ConnectorDetached: "connector.detached";
+    readonly ConnectorHealth: "connector.health";
+    readonly ConnectorError: "connector.error";
+    readonly AgentRegistered: "agent.registered";
+    readonly AgentUnregistered: "agent.unregistered";
+    readonly AgentUpdated: "agent.updated";
+    readonly ChannelCreated: "collaboration.channel_created";
+    readonly ThreadCreated: "collaboration.thread_created";
+    readonly MessageSent: "collaboration.message_sent";
+    readonly SystemConfig: "system.config";
+    readonly SystemError: "system.error";
+};
+/** Union of all valid audit event type string values. */
+type AuditEventType = (typeof AuditEventTypeEnum)[keyof typeof AuditEventTypeEnum];
+/** Ordered list of all event types (useful for validation / UI dropdowns). */
+declare const AUDIT_EVENT_TYPES: readonly AuditEventType[];
+declare const AuditActorKindEnum: {
+    readonly Agent: "agent";
+    readonly User: "user";
+    readonly System: "system";
+    readonly Connector: "connector";
+};
+type AuditActorKind = (typeof AuditActorKindEnum)[keyof typeof AuditActorKindEnum];
+interface AuditActor {
+    kind: AuditActorKind;
+    id: string;
+    name?: string;
+    platform?: RecoderAgentPlatform;
+    metadata?: Record<string, unknown>;
+}
+declare const AuditTargetKindEnum: {
+    readonly Task: "task";
+    readonly Agent: "agent";
+    readonly Connector: "connector";
+    readonly Channel: "channel";
+    readonly Thread: "thread";
+    readonly Message: "message";
+    readonly Policy: "policy";
+    readonly Workspace: "workspace";
+    readonly System: "system";
+};
+type AuditTargetKind = (typeof AuditTargetKindEnum)[keyof typeof AuditTargetKindEnum];
+interface AuditTarget {
+    kind: AuditTargetKind;
+    id: string;
+    name?: string;
+    metadata?: Record<string, unknown>;
+}
+interface AuditPolicyContext {
+    action: string;
+    rule: string;
+    approved: boolean;
+    reason: string;
+    agent_id: string;
+    details?: Record<string, unknown>;
+}
+declare const AuditSeverityEnum: {
+    readonly Info: "info";
+    readonly Warning: "warning";
+    readonly Error: "error";
+    readonly Critical: "critical";
+};
+type AuditSeverity = (typeof AuditSeverityEnum)[keyof typeof AuditSeverityEnum];
+interface AuditEvent {
+    schema_version: string;
+    id: string;
+    event_type: AuditEventType;
+    severity?: AuditSeverity;
+    actor: AuditActor;
+    target: AuditTarget;
+    trace_id: string;
+    parent_event_id?: string;
+    workspace_id: string;
+    thread_id?: string;
+    task_id?: string;
+    timestamp: string;
+    duration_ms?: number;
+    policy?: AuditPolicyContext;
+    metadata?: Record<string, unknown>;
+    tags?: string[];
+}
+interface CreateAuditEventInput {
+    id: string;
+    event_type: AuditEventType;
+    actor: AuditActor;
+    target: AuditTarget;
+    trace_id: string;
+    workspace_id: string;
+    thread_id?: string;
+    task_id?: string;
+    parent_event_id?: string;
+    severity?: AuditSeverity;
+    policy?: AuditPolicyContext;
+    metadata?: Record<string, unknown>;
+    tags?: string[];
+    duration_ms?: number;
+    now?: string;
+}
+declare function createAuditEvent(input: CreateAuditEventInput): AuditEvent;
+
+export { AUDIT_EVENT_TYPES as A, type CreateAuditEventInput as C, AUDIT_EVENT_VERSION as a, type AuditActor as b, type AuditActorKind as c, AuditActorKindEnum as d, type AuditEvent as e, type AuditEventType as f, AuditEventTypeEnum as g, type AuditPolicyContext as h, type AuditSeverity as i, AuditSeverityEnum as j, type AuditTarget as k, type AuditTargetKind as l, AuditTargetKindEnum as m, createAuditEvent as n };

package/dist/audit-helpers.d.mts

@@ -1,5 +1,5 @@
-import { AuditEvent } from '@recoder/shared/a2a/schemas';
-import { RecoderAgentPlatform } from '@recoder/shared/a2a';
+import { R as RecoderAgentPlatform } from './types-Bt96SgOS.mjs';
+import { e as AuditEvent } from './audit-event-Bhf9-AJV.mjs';
 
 /**
  * @module audit-helpers

package/dist/audit-helpers.d.ts

@@ -1,5 +1,5 @@
-import { AuditEvent } from '@recoder/shared/a2a/schemas';
-import { RecoderAgentPlatform } from '@recoder/shared/a2a';
+import { R as RecoderAgentPlatform } from './types-Bt96SgOS.js';
+import { e as AuditEvent } from './audit-event-D8PTRp8M.js';
 
 /**
  * @module audit-helpers

package/dist/audit-helpers.js

@@ -37,7 +37,7 @@ __export(audit_helpers_exports, {
 });
 module.exports = __toCommonJS(audit_helpers_exports);
 
-// ../../shared/src/a2a/schemas/task-envelope.ts
+// src/schemas/task-envelope.ts
 var TaskStateEnum = {
   /** Task has been created and is awaiting execution. */
   Submitted: "submitted",
@@ -79,69 +79,43 @@ var ALLOWED_STATE_TRANSITIONS = {
   [TaskStateEnum.Cancelled]: []
 };
 
-// ../../shared/src/a2a/schemas/audit-event.ts
+// src/schemas/audit-event.ts
 var AUDIT_EVENT_VERSION = "1.0.0";
 var AuditEventTypeEnum = {
   // -- task lifecycle ---------------------------------------------------------
-  /** A new task was submitted. */
   TaskSubmitted: "task.submitted",
-  /** Task execution started. */
   TaskStarted: "task.started",
-  /** Task made progress (intermediate update). */
   TaskProgress: "task.progress",
-  /** Assignee agent needs additional input. */
   TaskInputRequired: "task.input_required",
-  /** Task completed successfully. */
   TaskCompleted: "task.completed",
-  /** Task failed with an error. */
   TaskFailed: "task.failed",
-  /** Task was cancelled. */
   TaskCancelled: "task.cancelled",
   // -- policy decisions -------------------------------------------------------
-  /** A policy check was performed. */
   PolicyChecked: "policy.checked",
-  /** A policy action was approved (auto or prompt). */
   PolicyApproved: "policy.approved",
-  /** A policy action was denied. */
   PolicyDenied: "policy.denied",
   // -- connector events -------------------------------------------------------
-  /** A connector was attached to an agent. */
   ConnectorAttached: "connector.attached",
-  /** A connector was detached from an agent. */
   ConnectorDetached: "connector.detached",
-  /** A connector emitted a diagnostic or health event. */
   ConnectorHealth: "connector.health",
-  /** A connector encountered an error. */
   ConnectorError: "connector.error",
   // -- agent registry ---------------------------------------------------------
-  /** An agent was registered. */
   AgentRegistered: "agent.registered",
-  /** An agent was unregistered. */
   AgentUnregistered: "agent.unregistered",
-  /** An agent's capabilities were updated. */
   AgentUpdated: "agent.updated",
   // -- collaboration ----------------------------------------------------------
-  /** A collaboration channel was created. */
   ChannelCreated: "collaboration.channel_created",
-  /** A collaboration thread was created. */
   ThreadCreated: "collaboration.thread_created",
-  /** A message was sent in a collaboration thread. */
   MessageSent: "collaboration.message_sent",
   // -- system -----------------------------------------------------------------
-  /** A system-level configuration change. */
   SystemConfig: "system.config",
-  /** A system-level error or warning. */
   SystemError: "system.error"
 };
 var AUDIT_EVENT_TYPES = Object.values(AuditEventTypeEnum);
 var AuditActorKindEnum = {
-  /** An AI agent. */
   Agent: "agent",
-  /** A human user. */
   User: "user",
-  /** An internal system service (e.g. policy engine, scheduler). */
   System: "system",
-  /** A connector/adapter. */
   Connector: "connector"
 };
 var AuditTargetKindEnum = {
@@ -156,13 +130,9 @@ var AuditTargetKindEnum = {
   System: "system"
 };
 var AuditSeverityEnum = {
-  /** Informational -- normal operation. */
   Info: "info",
-  /** Warning -- something unexpected but not an error. */
   Warning: "warning",
-  /** Error -- an operation failed. */
   Error: "error",
-  /** Critical -- a severe failure requiring immediate attention. */
   Critical: "critical"
 };
 function createAuditEvent(input) {
@@ -186,119 +156,70 @@ function createAuditEvent(input) {
   };
 }
 
-// ../../shared/src/a2a/schemas/error-taxonomy.ts
+// src/schemas/error-taxonomy.ts
 var A2AErrorSeverityEnum = {
-  /** Low impact -- informational or gracefully handled. */
   Low: "low",
-  /** Medium impact -- degraded functionality but system continues. */
   Medium: "medium",
-  /** High impact -- a key operation failed and needs attention. */
   High: "high",
-  /** Critical -- system stability at risk, immediate action required. */
   Critical: "critical"
 };
 var A2AErrorCategoryEnum = {
-  /** Errors in the envelope or message format (validation, parsing). */
   Envelope: "envelope",
-  /** Errors in the connector/adapter layer. */
   Connector: "connector",
-  /** Errors in the policy/approval plane. */
   Policy: "policy",
-  /** Errors in the task orchestration layer. */
   Task: "task",
-  /** Errors in the agent registry. */
   Registry: "registry",
-  /** Errors in the collaboration service. */
   Collaboration: "collaboration",
-  /** Transport/network-level errors. */
   Transport: "transport",
-  /** Authentication and authorization errors. */
   Auth: "auth",
-  /** Rate-limiting and quota errors. */
   RateLimit: "rate_limit",
-  /** Internal / unexpected errors. */
   Internal: "internal"
 };
 var A2AErrorCodeEnum = {
   // -- envelope ---------------------------------------------------------------
-  /** The envelope failed structural validation. */
   InvalidEnvelope: "INVALID_ENVELOPE",
-  /** The envelope version is unsupported. */
   UnsupportedEnvelopeVersion: "UNSUPPORTED_ENVELOPE_VERSION",
-  /** A required field is missing from the envelope. */
   MissingEnvelopeField: "MISSING_ENVELOPE_FIELD",
-  /** The payload kind is unknown or malformed. */
   InvalidPayload: "INVALID_PAYLOAD",
-  /** Compatibility alias used by older gateway/workspace routes. */
   InvalidParams: "INVALID_ENVELOPE",
   // -- connector --------------------------------------------------------------
-  /** No connector is attached for the target agent. */
   ConnectorNotFound: "CONNECTOR_NOT_FOUND",
-  /** The connector timed out during task execution. */
   ConnectorTimeout: "CONNECTOR_TIMEOUT",
-  /** The connector returned an unexpected error. */
   ConnectorError: "CONNECTOR_ERROR",
-  /** The connector is temporarily unavailable. */
   ConnectorUnavailable: "CONNECTOR_UNAVAILABLE",
-  /** Protocol mismatch between connector and remote agent. */
   ProtocolMismatch: "PROTOCOL_MISMATCH",
   // -- policy -----------------------------------------------------------------
-  /** The policy plane denied the requested action. */
   PolicyDenied: "POLICY_DENIED",
-  /** No prompt handler is configured for the policy rule. */
   PolicyHandlerMissing: "POLICY_HANDLER_MISSING",
-  /** The policy evaluation timed out. */
   PolicyTimeout: "POLICY_TIMEOUT",
   // -- task -------------------------------------------------------------------
-  /** The task was not found. */
   TaskNotFound: "TASK_NOT_FOUND",
-  /** An invalid state transition was attempted. */
   InvalidStateTransition: "INVALID_STATE_TRANSITION",
-  /** The task has already reached a terminal state. */
   TaskAlreadyTerminal: "TASK_ALREADY_TERMINAL",
-  /** The task failed during execution. */
   TaskExecutionFailed: "TASK_EXECUTION_FAILED",
-  /** The task was cancelled. */
   TaskCancelled: "TASK_CANCELLED",
   // -- registry ---------------------------------------------------------------
-  /** The agent was not found in the registry. */
   AgentNotFound: "AGENT_NOT_FOUND",
-  /** The agent is already registered. */
   AgentAlreadyRegistered: "AGENT_ALREADY_REGISTERED",
-  /** The agent does not have the requested capability. */
   CapabilityNotFound: "CAPABILITY_NOT_FOUND",
   // -- collaboration ----------------------------------------------------------
-  /** The channel was not found. */
   ChannelNotFound: "CHANNEL_NOT_FOUND",
-  /** The thread was not found. */
   ThreadNotFound: "THREAD_NOT_FOUND",
-  /** The message was not found. */
   MessageNotFound: "MESSAGE_NOT_FOUND",
-  /** The sender is not a member of the target channel. */
   NotChannelMember: "NOT_CHANNEL_MEMBER",
   // -- transport --------------------------------------------------------------
-  /** A network request failed. */
   NetworkError: "NETWORK_ERROR",
-  /** The remote endpoint returned an unexpected status. */
   UnexpectedStatus: "UNEXPECTED_STATUS",
-  /** The request or response body could not be parsed. */
   SerializationError: "SERIALIZATION_ERROR",
   // -- auth -------------------------------------------------------------------
-  /** Authentication failed (invalid or missing credentials). */
   AuthenticationFailed: "AUTHENTICATION_FAILED",
-  /** The caller is not authorized for the requested operation. */
   AuthorizationDenied: "AUTHORIZATION_DENIED",
-  /** The access token has expired. */
   TokenExpired: "TOKEN_EXPIRED",
   // -- rate limit -------------------------------------------------------------
-  /** The caller has exceeded the rate limit. */
   RateLimitExceeded: "RATE_LIMIT_EXCEEDED",
-  /** The caller has exceeded their usage quota. */
   QuotaExceeded: "QUOTA_EXCEEDED",
   // -- internal ---------------------------------------------------------------
-  /** An unexpected internal error occurred. */
   InternalError: "INTERNAL_ERROR",
-  /** A configuration error was detected. */
   ConfigurationError: "CONFIGURATION_ERROR"
 };
 var A2A_ERROR_CODE_REGISTRY = {