@ikenga/contract 0.5.0 → 0.6.0

package/dist/{engine.d.ts → engine/adapter.d.ts}

@@ -1,16 +1,36 @@
+/**
+ * Legacy Engine adapter shape. New adapters target `./acp.ts`. Both are
+ * exported through `@ikenga/contract/engine` during the deprecation cycle.
+ *
+ * Engine adapter contract. Implementations:
+ *   - engine-claude-code  (default, ships preinstalled)
+ *   - engine-codex        (future)
+ *   - engine-aider        (future)
+ *   - engine-noop         (testing / shell-without-AI mode)
+ *
+ * @deprecated Phase 11 retires this surface. New adapters target the ACP
+ *   shape in `./acp.ts` (`AcpEngine`, `createAcpEngine`, `AcpHost`).
+ */
 import { z } from 'zod';
+/** @deprecated Use the ACP shape in `./acp.ts`. */
 export interface SessionOpts {
     cwd?: string;
     systemPrompt?: string;
     toolAllowList?: string[];
     /** Caller pkg id, used by the engine for per-pkg billing/audit. */
     callerPkg?: string;
+    /** Model override for the session (adapter-specific). */
+    model?: string;
+    /** Resume a prior session by id (adapter-specific; requires sessionResume cap). */
+    resumeSessionId?: string;
 }
+/** @deprecated Use the ACP shape in `./acp.ts`. */
 export interface Session {
     readonly id: string;
     /** Best-effort cancellation. Resolves once the engine has stopped streaming. */
     cancel(): Promise<void>;
 }
+/** @deprecated Use `AcpSessionUpdate` from `./acp.ts`. */
 export type EngineEvent = {
     type: 'message_delta';
     text: string;
@@ -38,6 +58,11 @@ export type EngineEvent = {
     reason: 'stop' | 'cancel' | 'error';
     error?: string;
 };
+/**
+ * MCP server spec. Shared between the legacy `Engine` surface and the ACP
+ * `newSession` request — not marked `@deprecated` because the ACP shape
+ * reuses it verbatim.
+ */
 export interface McpServerSpec {
     id: string;
     command: string;
@@ -275,6 +300,39 @@ export declare const EngineProvidesSchema: z.ZodObject<{
     } | undefined;
 }>;
 export type EngineProvides = z.infer<typeof EngineProvidesSchema>;
+/**
+ * Static metadata every adapter surfaces via `Engine.metadata`. Mirrors the
+ * manifest's `engine` block so the shell + wizard can introspect without
+ * re-parsing the manifest.
+ */
+export interface EngineMetadata {
+    agentId: string;
+    display: string;
+    capabilities: AgentCapabilities;
+    onboarding: EngineOnboarding;
+}
+/**
+ * Tauri-command surface the host shell exposes to legacy `Engine` adapters.
+ * The shell binds these names to its `claude_chat_*` commands; adapters
+ * never call `invoke()` directly so they remain testable.
+ *
+ * @deprecated Use the ACP shape (`AcpHost` in `./acp.ts`) for new adapters.
+ */
+export interface HostBridge {
+    spawn(opts: {
+        sessionId: string;
+        cwd?: string;
+        systemPrompt?: string;
+        model?: string;
+        resumeSessionId?: string;
+    }): Promise<void>;
+    send(sessionId: string, message: string): Promise<void>;
+    kill(sessionId: string): Promise<void>;
+    listen(sessionId: string): AsyncIterable<EngineEvent>;
+    registerMcp(spec: McpServerSpec): Promise<void>;
+    unregisterMcp(id: string): Promise<void>;
+}
+/** @deprecated Use `AcpEngine` from `./acp.ts`. Legacy shape retired in Phase 11. */
 export interface Engine {
     /** Stable identifier — matches the pkg id of the engine adapter. */
     readonly id: string;
@@ -286,12 +344,7 @@ export interface Engine {
      * / onboarding so the shell and wizard can introspect without re-parsing
      * the manifest.
      */
-    readonly metadata: {
-        agentId: string;
-        display: string;
-        capabilities: AgentCapabilities;
-        onboarding: EngineOnboarding;
-    };
+    readonly metadata: EngineMetadata;
     /** Open a new session. Sessions are cheap; create one per pkg invocation. */
     startSession(opts: SessionOpts): Promise<Session>;
     /** Send input and stream events. The iterable completes on `done`. */
@@ -335,240 +388,4 @@ export interface AdapterLoader {
      */
     fallback(): Engine;
 }
-/** ACP `ProtocolVersion`. Numeric. V1 = 1. */
-export type AcpProtocolVersion = number;
-export interface AcpInitializeRequest {
-    protocolVersion: AcpProtocolVersion;
-    /** Optional `_meta` passthrough; the in-process shell ignores it. */
-    _meta?: Record<string, unknown>;
-}
-export interface AcpPromptCapabilities {
-    image: boolean;
-    audio: boolean;
-    embeddedContext: boolean;
-}
-export interface AcpMcpCapabilities {
-    http: boolean;
-    sse: boolean;
-}
-export interface AcpAgentCapabilities {
-    loadSession: boolean;
-    promptCapabilities: AcpPromptCapabilities;
-    mcpCapabilities: AcpMcpCapabilities;
-}
-export interface AcpInitializeResponse {
-    protocolVersion: AcpProtocolVersion;
-    agentCapabilities: AcpAgentCapabilities;
-    /** Authentication methods the agent supports — opaque structure passed
-     *  through to the wizard. */
-    authMethods?: unknown[];
-    _meta?: Record<string, unknown>;
-}
-export interface AcpTextContentBlock {
-    type: 'text';
-    text: string;
-}
-/** ACP `ContentBlock::Image`. `data` is raw base64 with NO `data:` URI prefix. */
-export interface AcpImageContentBlock {
-    type: 'image';
-    data: string;
-    mimeType: string;
-    uri?: string;
-}
-export type AcpContentBlock = AcpTextContentBlock | AcpImageContentBlock | {
-    type: 'audio';
-    data: string;
-    mimeType: string;
-} | {
-    type: 'resource_link';
-    name: string;
-    uri: string;
-} | {
-    type: 'resource';
-    resource: unknown;
-};
-export interface AcpNewSessionRequest {
-    cwd: string;
-    mcpServers: McpServerSpec[];
-    _meta?: Record<string, unknown>;
-}
-/** The four canonical ACP session modes the Rust ACP server advertises. */
-export type AcpSessionModeId = 'plan' | 'default' | 'auto' | 'bypassPermissions';
-export interface AcpSessionMode {
-    id: AcpSessionModeId;
-    name: string;
-    description?: string;
-    _meta?: Record<string, unknown>;
-}
-export interface AcpSessionModes {
-    currentModeId: AcpSessionModeId;
-    availableModes: AcpSessionMode[];
-    _meta?: Record<string, unknown>;
-}
-export interface AcpNewSessionResponse {
-    sessionId: string;
-    modes?: AcpSessionModes;
-    models?: unknown;
-    configOptions?: unknown[];
-    _meta?: Record<string, unknown>;
-}
-export interface AcpPromptRequest {
-    sessionId: string;
-    prompt: AcpContentBlock[];
-    messageId?: string;
-    _meta?: Record<string, unknown>;
-}
-export type AcpStopReason = 'end_turn' | 'max_tokens' | 'max_turn_requests' | 'refusal' | 'cancelled';
-export interface AcpPromptResponse {
-    stopReason: AcpStopReason;
-    userMessageId?: string;
-    usage?: unknown;
-    _meta?: Record<string, unknown>;
-}
-/** ACP `SessionUpdate` discriminated union. Open-ended on the `string` tail
- *  so adapter-specific extensions don't break TS consumers. */
-export type AcpSessionUpdate = {
-    sessionUpdate: 'agent_message_chunk';
-    content: AcpContentBlock;
-    messageId?: string;
-} | {
-    sessionUpdate: 'agent_thought_chunk';
-    content: AcpContentBlock;
-    messageId?: string;
-} | {
-    sessionUpdate: 'user_message_chunk';
-    content: AcpContentBlock;
-} | {
-    sessionUpdate: 'tool_call';
-    toolCallId: string;
-    title: string;
-    kind?: string;
-    status?: string;
-    content?: unknown[];
-    rawInput?: unknown;
-    _meta?: Record<string, unknown>;
-} | {
-    sessionUpdate: 'tool_call_update';
-    toolCallId: string;
-    fields: {
-        status?: string;
-        content?: unknown[];
-        rawOutput?: unknown;
-    };
-    _meta?: Record<string, unknown>;
-} | {
-    sessionUpdate: 'current_mode_update';
-    currentModeId: AcpSessionModeId;
-} | {
-    sessionUpdate: 'plan_update';
-    plan: unknown;
-} | {
-    sessionUpdate: string;
-    [k: string]: unknown;
-};
-export interface AcpSessionNotification {
-    sessionId: string;
-    update: AcpSessionUpdate;
-    _meta?: Record<string, unknown>;
-}
-export type AcpPermissionOptionKind = 'allow_once' | 'allow_always' | 'reject_once' | 'reject_always';
-export interface AcpPermissionOption {
-    optionId: string;
-    name: string;
-    kind: AcpPermissionOptionKind;
-}
-export interface AcpToolCallSummary {
-    toolCallId: string;
-    title?: string;
-    kind?: string;
-    status?: string;
-    content?: unknown[];
-    rawInput?: unknown;
-    rawOutput?: unknown;
-}
-export interface AcpRequestPermissionRequest {
-    sessionId: string;
-    toolCall: AcpToolCallSummary;
-    options: AcpPermissionOption[];
-    _meta?: Record<string, unknown>;
-}
-export type AcpRequestPermissionOutcome = {
-    outcome: 'cancelled';
-} | {
-    outcome: 'selected';
-    optionId: string;
-};
-export interface AcpRequestPermissionResponse {
-    outcome: AcpRequestPermissionOutcome;
-    _meta?: Record<string, unknown>;
-}
-/** Wire envelope: pairs a `requestId` with the request body so the client
- *  reply can address the parked Rust-side oneshot. */
-export interface AcpPermissionRequestEnvelope {
-    requestId: string;
-    request: AcpRequestPermissionRequest;
-}
-export interface AcpLoadSessionResponse {
-    /** Optional mode advertisement so the picker can hydrate without paying
-     *  the cold-spawn cost of `newSession`. */
-    modes?: AcpSessionModes;
-}
-export interface AcpForkResult {
-    newThreadId: string;
-    sourceThreadId: string;
-    branchedFromTurn?: number;
-}
-export interface AcpForkOpts {
-    upToTurn?: number;
-    label?: string;
-}
-export type AcpNotifyKind = 'notification' | 'permissionRequest';
-export interface AcpNotifyPayload {
-    threadId: string;
-    title: string;
-    body: string;
-    kind: AcpNotifyKind;
-}
-/**
- * ACP-shaped engine adapter. Implementations:
- *   - `pkgs/engine-claude-code` — wraps the in-process Rust ACP server.
- *   - future: `pkgs/engine-codex`, `pkgs/engine-aider` — each speaking the
- *     same wire shapes.
- *
- * Method names mirror ACP verbatim (`newSession`, `prompt`, `cancel`,
- * `setMode`, `loadSession`, `forkSession`, `respondPermission`) so the wire
- * layer, adapter layer, and host shell share one vocabulary.
- *
- * Subscriptions return a synchronous `() => void` unsubscribe — the
- * implementation may resolve the underlying tauri-listener asynchronously
- * but the caller can drop the registration immediately on unmount.
- */
-export interface AcpEngine {
-    initialize(req: AcpInitializeRequest): Promise<AcpInitializeResponse>;
-    /** Mint a new session. The agent may lazily spawn its child on the first
-     *  `prompt` rather than during `newSession` itself. */
-    newSession(req: AcpNewSessionRequest): Promise<AcpNewSessionResponse>;
-    /** Send a turn. Resolves when the turn ends; in-progress events flow via
-     *  `onSessionUpdate`. */
-    prompt(req: AcpPromptRequest): Promise<AcpPromptResponse>;
-    /** Clean interrupt. Preserves the transcript and keeps the child alive
-     *  for the next turn. */
-    cancel(sessionId: string): Promise<void>;
-    /** Switch the session's permission mode. */
-    setMode(sessionId: string, modeId: AcpSessionModeId): Promise<void>;
-    /** Re-attach to an existing session by id. The child stays lazy. */
-    loadSession(sessionId: string): Promise<AcpLoadSessionResponse>;
-    /** Clone a session from a chosen turn. The new thread inherits the source's
-     *  on-disk transcript so the first prompt resumes from the cutoff. */
-    forkSession(sourceSessionId: string, opts?: AcpForkOpts): Promise<AcpForkResult>;
-    /** Subscribe to session updates. Returns a sync unsubscribe. */
-    onSessionUpdate(sessionId: string, callback: (update: AcpSessionUpdate) => void): () => void;
-    /** Subscribe to permission requests for this session. Reply via
-     *  `respondPermission`. Returns a sync unsubscribe. */
-    onPermissionRequest(sessionId: string, callback: (envelope: AcpPermissionRequestEnvelope) => void): () => void;
-    /** Reply to a parked permission request. */
-    respondPermission(requestId: string, response: AcpRequestPermissionResponse): Promise<void>;
-    /** Subscribe to OS-attention notifications. Returns a sync unsubscribe. */
-    onNotify(callback: (payload: AcpNotifyPayload) => void): () => void;
-}
-//# sourceMappingURL=engine.d.ts.map
+//# sourceMappingURL=adapter.d.ts.map

package/dist/engine/adapter.d.ts.map

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

package/dist/{engine.js → engine/adapter.js}

@@ -1,8 +1,16 @@
-// Engine adapter contract. Implementations:
-//   - engine-claude-code  (default, ships preinstalled)
-//   - engine-codex        (future)
-//   - engine-aider        (future)
-//   - engine-noop         (testing / shell-without-AI mode)
+/**
+ * Legacy Engine adapter shape. New adapters target `./acp.ts`. Both are
+ * exported through `@ikenga/contract/engine` during the deprecation cycle.
+ *
+ * Engine adapter contract. Implementations:
+ *   - engine-claude-code  (default, ships preinstalled)
+ *   - engine-codex        (future)
+ *   - engine-aider        (future)
+ *   - engine-noop         (testing / shell-without-AI mode)
+ *
+ * @deprecated Phase 11 retires this surface. New adapters target the ACP
+ *   shape in `./acp.ts` (`AcpEngine`, `createAcpEngine`, `AcpHost`).
+ */
 import { z } from 'zod';
 // ---------- Capabilities (single source of truth) ----------
 /**
@@ -82,4 +90,4 @@ export const EngineProvidesSchema = z.object({
         requiredEnvVars: [],
     }),
 });
-//# sourceMappingURL=engine.js.map
+//# sourceMappingURL=adapter.js.map

package/dist/engine/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/engine/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2CxB,8DAA8D;AAE9D;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,kEAAkE;IAClE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,6DAA6D;IAC7D,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,2EAA2E;IAC3E,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,mFAAmF;IACnF,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,oDAAoD;IACpD,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE;IAC5B,oCAAoC;IACpC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;IACvB,gDAAgD;IAChD,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;IAC1B,8CAA8C;IAC9C,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE;IAC3B,2EAA2E;IAC3E,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;IAC1B,qEAAqE;IACrE,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE;IACzB,+DAA+D;IAC/D,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE;IAChB,wCAAwC;IACxC,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;CAC3B,CAAC,CAAC;AAGH,2DAA2D;AAE3D;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,sFAAsF;IACtF,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAClD,4DAA4D;IAC5D,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAChD;;;OAGG;IACH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,4CAA4C;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAGH;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C;;;;OAIG;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,0EAA0E;IAC1E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,gDAAgD;IAChD,YAAY,EAAE,uBAAuB;IACrC,sDAAsD;IACtD,UAAU,EAAE,sBAAsB,CAAC,OAAO,CAAC;QACzC,iBAAiB,EAAE,EAAE;QACrB,eAAe,EAAE,EAAE;KACpB,CAAC;CACH,CAAC,CAAC"}

package/dist/engine/errors.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared error types for engine adapters.
+ *
+ * Stub adapters (e.g. `engine-codex`, `engine-gemini`) detect a CLI on the
+ * host but don't yet implement `send` / `prompt`. They throw
+ * `EngineNotImplementedError` so the shell can render an actionable
+ * onboarding hint (the optional `docsUrl`) instead of a generic crash.
+ */
+export declare class EngineNotImplementedError extends Error {
+    readonly engineId: string;
+    readonly docsUrl?: string;
+    constructor(engineId: string, opts?: {
+        docsUrl?: string;
+        message?: string;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/engine/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/engine/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEd,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;CAM5E"}

package/dist/engine/errors.js

@@ -0,0 +1,19 @@
+/**
+ * Shared error types for engine adapters.
+ *
+ * Stub adapters (e.g. `engine-codex`, `engine-gemini`) detect a CLI on the
+ * host but don't yet implement `send` / `prompt`. They throw
+ * `EngineNotImplementedError` so the shell can render an actionable
+ * onboarding hint (the optional `docsUrl`) instead of a generic crash.
+ */
+export class EngineNotImplementedError extends Error {
+    engineId;
+    docsUrl;
+    constructor(engineId, opts) {
+        super(opts?.message ?? `Engine ${engineId} is not implemented yet`);
+        this.name = 'EngineNotImplementedError';
+        this.engineId = engineId;
+        this.docsUrl = opts?.docsUrl;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/engine/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/engine/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACzC,QAAQ,CAAS;IACjB,OAAO,CAAU;IAE1B,YAAY,QAAgB,EAAE,IAA6C;QACzE,KAAK,CAAC,IAAI,EAAE,OAAO,IAAI,UAAU,QAAQ,yBAAyB,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC;IAC/B,CAAC;CACF"}

package/dist/engine/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `@ikenga/contract/engine` — engine adapter surface.
+ *
+ * Exports BOTH the legacy `Engine` shape (`./adapter`) and the ACP-shaped
+ * surface (`./acp`) side-by-side for one deprecation cycle. Legacy types
+ * carry `@deprecated` JSDoc pointing at the ACP path. Shared error types
+ * live in `./errors`.
+ */
+export * from './adapter.js';
+export * from './acp.js';
+export * from './errors.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}

package/dist/engine/index.js

@@ -0,0 +1,12 @@
+/**
+ * `@ikenga/contract/engine` — engine adapter surface.
+ *
+ * Exports BOTH the legacy `Engine` shape (`./adapter`) and the ACP-shaped
+ * surface (`./acp`) side-by-side for one deprecation cycle. Legacy types
+ * carry `@deprecated` JSDoc pointing at the ACP path. Shared error types
+ * live in `./errors`.
+ */
+export * from './adapter.js';
+export * from './acp.js';
+export * from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}

package/dist/index.d.ts

@@ -1,10 +1,11 @@
 export * from './manifest.js';
 export * from './rpc.js';
-export * from './engine.js';
+export * from './engine/index.js';
 export * from './scopes.js';
 export * from './iyke.js';
 export * from './artifact.js';
 export * from './registry.js';
+export * from './browser.js';
 /** This package's own version. */
 export declare const CONTRACT_PACKAGE_VERSION: "0.5.0";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAE9B,kCAAkC;AAClC,eAAO,MAAM,wBAAwB,EAAG,OAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAE7B,kCAAkC;AAClC,eAAO,MAAM,wBAAwB,EAAG,OAAgB,CAAC"}

package/dist/index.js

@@ -1,10 +1,11 @@
 export * from './manifest.js';
 export * from './rpc.js';
-export * from './engine.js';
+export * from './engine/index.js';
 export * from './scopes.js';
 export * from './iyke.js';
 export * from './artifact.js';
 export * from './registry.js';
+export * from './browser.js';
 /** This package's own version. */
 export const CONTRACT_PACKAGE_VERSION = '0.5.0';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAE9B,kCAAkC;AAClC,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAE7B,kCAAkC;AAClC,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAgB,CAAC"}