@yan162/changewayguard 6.8.25

package/dist/agent/hook-types.d.ts

@@ -0,0 +1,276 @@
+/**
+ * Type definitions for all 24 OpenClaw plugin hooks.
+ *
+ * These types define the event data structure for each hook,
+ * enabling complete context reporting to Core for intent-action mismatch detection.
+ */
+export type HookType = "before_agent_start" | "agent_end" | "session_start" | "session_end" | "message_received" | "message_sending" | "message_sent" | "before_message_write" | "before_model_resolve" | "before_prompt_build" | "llm_input" | "llm_output" | "before_tool_call" | "after_tool_call" | "tool_result_persist" | "before_compaction" | "after_compaction" | "before_reset" | "subagent_spawning" | "subagent_delivery_target" | "subagent_spawned" | "subagent_ended" | "gateway_start" | "gateway_stop";
+/** Hooks that require synchronous response from Core (can block execution) */
+export declare const BLOCKING_HOOKS: Set<HookType>;
+/** Check if a hook type requires synchronous (blocking) reporting */
+export declare function isBlockingHook(hookType: HookType): boolean;
+/** Base event data shared by all hooks */
+export type BaseEventData = {
+    /** ISO 8601 timestamp when the event occurred */
+    timestamp: string;
+};
+export type BeforeAgentStartData = BaseEventData & {
+    /** Initial user prompt/intent */
+    prompt: string;
+    /** System prompt if any */
+    systemPrompt?: string;
+    /** Conversation ID if resuming */
+    conversationId?: string;
+};
+export type AgentEndData = BaseEventData & {
+    /** How the agent ended */
+    reason: "user_exit" | "error" | "timeout" | "completed" | "unknown";
+    /** Error message if ended due to error */
+    error?: string;
+    /** Total duration of the conversation in ms */
+    durationMs?: number;
+};
+export type SessionStartData = BaseEventData & {
+    /** Session identifier */
+    sessionId: string;
+    /** Whether this is a new or resumed session */
+    isNew: boolean;
+};
+export type SessionEndData = BaseEventData & {
+    /** Session identifier */
+    sessionId: string;
+    /** Session duration in ms */
+    durationMs?: number;
+};
+export type MessageReceivedData = BaseEventData & {
+    /** Who sent the message */
+    from: "user" | "assistant" | "system" | "tool";
+    /** Message content (may be truncated for large content) */
+    content: string;
+    /** Content length before truncation */
+    contentLength: number;
+};
+export type MessageSendingData = BaseEventData & {
+    /** Target of the message */
+    to: "user" | "llm" | "tool";
+    /** Message content (may be truncated) */
+    content: string;
+    /** Content length before truncation */
+    contentLength: number;
+};
+export type MessageSentData = BaseEventData & {
+    /** Target of the message */
+    to: "user" | "llm" | "tool";
+    /** Success status */
+    success: boolean;
+    /** Duration to send in ms */
+    durationMs?: number;
+};
+export type BeforeMessageWriteData = BaseEventData & {
+    /** File path being written to (e.g., JSONL log) */
+    filePath: string;
+    /** Message being written (may be truncated) */
+    content: string;
+    /** Content length before truncation */
+    contentLength: number;
+};
+export type BeforeModelResolveData = BaseEventData & {
+    /** Requested model ID/name */
+    requestedModel: string;
+};
+export type BeforePromptBuildData = BaseEventData & {
+    /** Number of messages in history */
+    messageCount: number;
+    /** Total token estimate */
+    tokenEstimate?: number;
+};
+export type LlmInputData = BaseEventData & {
+    /** Model being called */
+    model: string;
+    /** Full prompt content (may be truncated for very large prompts) */
+    content: string;
+    /** Content length before truncation */
+    contentLength: number;
+    /** Number of messages in the request */
+    messageCount: number;
+    /** Token count if available */
+    tokenCount?: number;
+    /** System prompt if separate */
+    systemPrompt?: string;
+};
+export type LlmOutputData = BaseEventData & {
+    /** Model that responded */
+    model: string;
+    /** Response content (may be truncated) */
+    content: string;
+    /** Content length before truncation */
+    contentLength: number;
+    /** Whether the response was streamed */
+    streamed: boolean;
+    /** Tokens used (input + output) if available */
+    tokenUsage?: {
+        input: number;
+        output: number;
+        total: number;
+    };
+    /** Latency to first token / full response in ms */
+    latencyMs: number;
+    /** Stop reason */
+    stopReason?: "end_turn" | "max_tokens" | "tool_use" | "error" | string;
+};
+export type BeforeToolCallData = BaseEventData & {
+    /** Tool name being called */
+    toolName: string;
+    /** Tool parameters (sanitized) */
+    params: Record<string, unknown>;
+    /** Tool input hash for dedup */
+    inputHash?: string;
+};
+export type AfterToolCallData = BaseEventData & {
+    /** Tool name that was called */
+    toolName: string;
+    /** Tool parameters (sanitized) */
+    params: Record<string, unknown>;
+    /** Whether the call succeeded */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** Result summary (truncated if large) */
+    resultSummary?: string;
+    /** Result size in bytes */
+    resultSizeBytes: number;
+    /** Execution duration in ms */
+    durationMs: number;
+};
+export type ToolResultPersistData = BaseEventData & {
+    /** Tool name */
+    toolName?: string;
+    /** Whether the result was modified (e.g., quota message appended) */
+    modified: boolean;
+    /** Modification reason if modified */
+    modificationReason?: string;
+};
+export type BeforeCompactionData = BaseEventData & {
+    /** Number of messages before compaction */
+    messageCount: number;
+    /** Estimated token count before */
+    tokenEstimate?: number;
+    /** Reason for compaction */
+    reason: "token_limit" | "manual" | "auto";
+};
+export type AfterCompactionData = BaseEventData & {
+    /** Number of messages after compaction */
+    messageCount: number;
+    /** Messages removed */
+    removedCount: number;
+    /** Estimated token count after */
+    tokenEstimate?: number;
+};
+export type BeforeResetData = BaseEventData & {
+    /** Reason for reset */
+    reason: "user_request" | "error_recovery" | "context_overflow" | "unknown";
+    /** Number of messages being cleared */
+    messageCount: number;
+};
+export type SubagentSpawningData = BaseEventData & {
+    /** Subagent ID being created */
+    subagentId: string;
+    /** Type of subagent */
+    subagentType: string;
+    /** Task/prompt for the subagent */
+    task: string;
+    /** Task length before truncation */
+    taskLength: number;
+    /** Parent agent context */
+    parentContext?: string;
+};
+export type SubagentDeliveryTargetData = BaseEventData & {
+    /** Subagent ID */
+    subagentId: string;
+    /** Delivery target type */
+    targetType: string;
+    /** Target details */
+    targetDetails?: Record<string, unknown>;
+};
+export type SubagentSpawnedData = BaseEventData & {
+    /** Subagent ID that was created */
+    subagentId: string;
+    /** Subagent type */
+    subagentType: string;
+    /** Whether spawn was successful */
+    success: boolean;
+    /** Error if failed */
+    error?: string;
+};
+export type SubagentEndedData = BaseEventData & {
+    /** Subagent ID that ended */
+    subagentId: string;
+    /** How it ended */
+    reason: "completed" | "error" | "timeout" | "cancelled" | "unknown";
+    /** Result summary if completed */
+    resultSummary?: string;
+    /** Error message if failed */
+    error?: string;
+    /** Duration in ms */
+    durationMs?: number;
+};
+export type GatewayStartData = BaseEventData & {
+    /** Gateway port */
+    port: number;
+    /** Gateway URL */
+    url: string;
+};
+export type GatewayStopData = BaseEventData & {
+    /** Reason for stopping */
+    reason: "shutdown" | "error" | "restart" | "unknown";
+    /** Error if stopped due to error */
+    error?: string;
+};
+export type HookEventData = BeforeAgentStartData | AgentEndData | SessionStartData | SessionEndData | MessageReceivedData | MessageSendingData | MessageSentData | BeforeMessageWriteData | BeforeModelResolveData | BeforePromptBuildData | LlmInputData | LlmOutputData | BeforeToolCallData | AfterToolCallData | ToolResultPersistData | BeforeCompactionData | AfterCompactionData | BeforeResetData | SubagentSpawningData | SubagentDeliveryTargetData | SubagentSpawnedData | SubagentEndedData | GatewayStartData | GatewayStopData;
+/** A single hook event for reporting to Core */
+export type HookEvent = {
+    /** Event sequence number (monotonically increasing per session) */
+    seq: number;
+    /** Hook type */
+    hookType: HookType;
+    /** Event data specific to this hook type */
+    data: HookEventData;
+};
+/** Request body for POST /api/v1/events/stream */
+export type EventStreamRequest = {
+    /** Agent ID from credentials */
+    agentId: string;
+    /** Session key */
+    sessionKey: string;
+    /** Run ID for this conversation */
+    runId: string;
+    /** Array of events to report */
+    events: HookEvent[];
+    /** Client metadata */
+    meta: {
+        pluginVersion: string;
+        clientTimestamp: string;
+    };
+};
+/** Response from POST /api/v1/events/stream */
+export type EventStreamResponse = {
+    success: boolean;
+    data?: {
+        /** Number of events processed */
+        processed: number;
+        /** Block decisions for blocking hooks (keyed by seq) */
+        blocks?: Array<{
+            seq: number;
+            reason: string;
+            findings?: Array<{
+                riskLevel: string;
+                riskType: string;
+                reason: string;
+            }>;
+        }>;
+    };
+    error?: string;
+};
+/** Map of hook types to their expected data types (for runtime validation) */
+export declare const HOOK_DATA_FIELDS: Record<HookType, string[]>;
+//# sourceMappingURL=hook-types.d.ts.map

package/dist/agent/hook-types.d.ts.map

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

package/dist/agent/hook-types.js

@@ -0,0 +1,51 @@
+/**
+ * Type definitions for all 24 OpenClaw plugin hooks.
+ *
+ * These types define the event data structure for each hook,
+ * enabling complete context reporting to Core for intent-action mismatch detection.
+ */
+// =============================================================================
+// Blocking vs Non-Blocking Hook Classification
+// =============================================================================
+/** Hooks that require synchronous response from Core (can block execution) */
+export const BLOCKING_HOOKS = new Set([
+    "before_tool_call",
+    "subagent_spawning",
+    "message_sending",
+    "before_message_write",
+]);
+/** Check if a hook type requires synchronous (blocking) reporting */
+export function isBlockingHook(hookType) {
+    return BLOCKING_HOOKS.has(hookType);
+}
+// =============================================================================
+// Type Guard Helpers
+// =============================================================================
+/** Map of hook types to their expected data types (for runtime validation) */
+export const HOOK_DATA_FIELDS = {
+    before_agent_start: ["prompt"],
+    agent_end: ["reason"],
+    session_start: ["sessionId", "isNew"],
+    session_end: ["sessionId"],
+    message_received: ["from", "content", "contentLength"],
+    message_sending: ["to", "content", "contentLength"],
+    message_sent: ["to", "success"],
+    before_message_write: ["filePath", "content", "contentLength"],
+    before_model_resolve: ["requestedModel"],
+    before_prompt_build: ["messageCount"],
+    llm_input: ["model", "content", "contentLength", "messageCount"],
+    llm_output: ["model", "content", "contentLength", "streamed", "latencyMs"],
+    before_tool_call: ["toolName", "params"],
+    after_tool_call: ["toolName", "params", "success", "resultSizeBytes", "durationMs"],
+    tool_result_persist: ["modified"],
+    before_compaction: ["messageCount", "reason"],
+    after_compaction: ["messageCount", "removedCount"],
+    before_reset: ["reason", "messageCount"],
+    subagent_spawning: ["subagentId", "subagentType", "task", "taskLength"],
+    subagent_delivery_target: ["subagentId", "targetType"],
+    subagent_spawned: ["subagentId", "subagentType", "success"],
+    subagent_ended: ["subagentId", "reason"],
+    gateway_start: ["port", "url"],
+    gateway_stop: ["reason"],
+};
+//# sourceMappingURL=hook-types.js.map

package/dist/agent/hook-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-types.js","sourceRoot":"","sources":["../../agent/hook-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuCH,gFAAgF;AAChF,+CAA+C;AAC/C,gFAAgF;AAEhF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,cAAc,GAAkB,IAAI,GAAG,CAAC;IACnD,kBAAkB;IAClB,mBAAmB;IACnB,iBAAiB;IACjB,sBAAsB;CACvB,CAAC,CAAC;AAEH,qEAAqE;AACrE,MAAM,UAAU,cAAc,CAAC,QAAkB;IAC/C,OAAO,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC;AA2VD,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAA+B;IAC1D,kBAAkB,EAAE,CAAC,QAAQ,CAAC;IAC9B,SAAS,EAAE,CAAC,QAAQ,CAAC;IACrB,aAAa,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC;IACrC,WAAW,EAAE,CAAC,WAAW,CAAC;IAC1B,gBAAgB,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,eAAe,CAAC;IACtD,eAAe,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,eAAe,CAAC;IACnD,YAAY,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC;IAC/B,oBAAoB,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,eAAe,CAAC;IAC9D,oBAAoB,EAAE,CAAC,gBAAgB,CAAC;IACxC,mBAAmB,EAAE,CAAC,cAAc,CAAC;IACrC,SAAS,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,CAAC;IAChE,UAAU,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,CAAC;IAC1E,gBAAgB,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IACxC,eAAe,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,iBAAiB,EAAE,YAAY,CAAC;IACnF,mBAAmB,EAAE,CAAC,UAAU,CAAC;IACjC,iBAAiB,EAAE,CAAC,cAAc,EAAE,QAAQ,CAAC;IAC7C,gBAAgB,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC;IAClD,YAAY,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC;IACxC,iBAAiB,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,CAAC;IACvE,wBAAwB,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC;IACtD,gBAAgB,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,SAAS,CAAC;IAC3D,cAAc,EAAE,CAAC,YAAY,EAAE,QAAQ,CAAC;IACxC,aAAa,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;IAC9B,YAAY,EAAE,CAAC,QAAQ,CAAC;CACzB,CAAC"}

package/dist/agent/http-client.d.ts

@@ -0,0 +1,19 @@
+export type SignedJsonRequestOptions = {
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    url: string;
+    body?: unknown;
+    signal?: AbortSignal;
+    authorization?: string | null;
+    traceId?: string;
+    headers?: Record<string, string>;
+};
+export declare function createTraceId(): string;
+/**
+ * Unified signed JSON request sender for Core-facing APIs.
+ * Adds traceId header and request signing headers in one place.
+ */
+export declare function sendSignedJsonRequest(options: SignedJsonRequestOptions): Promise<{
+    response: Response;
+    traceId: string;
+}>;
+//# sourceMappingURL=http-client.d.ts.map

package/dist/agent/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../agent/http-client.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AAEF,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA4BlD"}

package/dist/agent/http-client.js

@@ -0,0 +1,37 @@
+import { randomBytes } from "node:crypto";
+import { buildSignedAuthHeadersForUrl } from "./auth.js";
+export function createTraceId() {
+    const randomNum = randomBytes(6).readUIntBE(0, 6);
+    return `${Date.now()}${String(randomNum).padStart(14, "0")}`;
+}
+/**
+ * Unified signed JSON request sender for Core-facing APIs.
+ * Adds traceId header and request signing headers in one place.
+ */
+export async function sendSignedJsonRequest(options) {
+    let traceId = options.traceId ?? createTraceId();
+    const signedHeaders = buildSignedAuthHeadersForUrl({
+        method: options.method,
+        url: options.url,
+        body: options.body,
+        traceId,
+        ...(options.authorization !== undefined ? { authorization: options.authorization } : {}),
+    });
+    if (typeof signedHeaders.traceId === "string" && signedHeaders.traceId.trim()) {
+        traceId = signedHeaders.traceId.trim();
+    }
+    const headers = {
+        "Content-Type": "application/json",
+        ...(options.headers ?? {}),
+        ...signedHeaders,
+        traceId,
+    };
+    const response = await fetch(options.url, {
+        method: options.method,
+        headers,
+        ...(options.body !== undefined ? { body: JSON.stringify(options.body) } : {}),
+        ...(options.signal ? { signal: options.signal } : {}),
+    });
+    return { response, traceId };
+}
+//# sourceMappingURL=http-client.js.map

package/dist/agent/http-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../agent/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,4BAA4B,EAAE,MAAM,WAAW,CAAC;AAYzD,MAAM,UAAU,aAAa;IAC3B,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClD,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAiC;IAEjC,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,aAAa,EAAE,CAAC;IACjD,MAAM,aAAa,GAAG,4BAA4B,CAAC;QACjD,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO;QACP,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzF,CAAC,CAAC;IACH,IAAI,OAAO,aAAa,CAAC,OAAO,KAAK,QAAQ,IAAI,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9E,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,kBAAkB;QAClC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QAC1B,GAAG,aAAa;QAChB,OAAO;KACR,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;QACxC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO;QACP,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC,CAAC;IAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC"}

package/dist/agent/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Agent module exports
+ */
+export { runGuardAgent, mapApiResponseToVerdict, type RunnerConfig } from "./runner.js";
+export { loadApiKey, loadCoreCredentials, saveCoreCredentials, registerWithCore, DEFAULT_CORE_URL, DEFAULT_CONFIG, resolveConfig, type CoreCredentials, } from "./config.js";
+export { sanitizeContent } from "./sanitizer.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../agent/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,cAAc,YAAY,CAAC"}

package/dist/agent/index.js

@@ -0,0 +1,8 @@
+/**
+ * Agent module exports
+ */
+export { runGuardAgent, mapApiResponseToVerdict } from "./runner.js";
+export { loadApiKey, loadCoreCredentials, saveCoreCredentials, registerWithCore, DEFAULT_CORE_URL, DEFAULT_CONFIG, resolveConfig, } from "./config.js";
+export { sanitizeContent } from "./sanitizer.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../agent/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAqB,MAAM,aAAa,CAAC;AACxF,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,aAAa,GAEd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,cAAc,YAAY,CAAC"}