@mquan/portal 0.0.1

package/dist/src/network/tasks.js

@@ -0,0 +1,276 @@
+import { randomUUID } from "node:crypto";
+import { normalizeSessionReference } from "../session-profile.js";
+import { envelopeSchema } from "./protocol.js";
+/** Bridges durable local task events to transport-independent relay envelopes. */
+export class RemoteTaskManager {
+    #service;
+    #remote;
+    #unsubscribe;
+    constructor(service, remote) {
+        this.#service = service;
+        this.#remote = remote;
+        this.#unsubscribe = remote.onEnvelope((serverUrl, envelope) => this.#receive(serverUrl, envelope));
+    }
+    close() {
+        this.#unsubscribe();
+    }
+    async delegate(input) {
+        const sender = this.#requireLocalSession(input.senderSessionId);
+        const serverUrl = this.#requireServer(input.senderSessionId);
+        const localPresence = await this.#requireLocalPresence(serverUrl, input.senderSessionId);
+        const candidates = await this.#resolveCandidates(input.senderSessionId, input.target);
+        if (candidates.length !== 1) {
+            return {
+                delivery: "not_sent",
+                resolution: candidates.length === 0 ? "unresolved" : "ambiguous",
+                candidates: candidates.map(toCandidate),
+            };
+        }
+        const target = candidates[0];
+        const now = new Date();
+        const ttlSeconds = input.ttlSeconds ?? 3_600;
+        if (!Number.isInteger(ttlSeconds) || ttlSeconds < 30 || ttlSeconds > 86_400) {
+            throw new RangeError("remote task TTL must be between 30 and 86400 seconds");
+        }
+        const expiresAt = new Date(now.getTime() + ttlSeconds * 1_000);
+        const taskId = `task_${randomUUID()}`;
+        const event = {
+            eventId: `event_${randomUUID()}`,
+            taskId,
+            kind: "offer",
+            state: "offered",
+            createdAt: now.toISOString(),
+            objective: input.objective,
+            ...(input.context === undefined ? {} : { context: input.context }),
+            ...(input.expectedResult === undefined ? {} : { expectedResult: input.expectedResult }),
+        };
+        const envelope = createEnvelope(localPresence.routeId, target.routeId, event, now, expiresAt);
+        const record = this.#service.index.repository.recordRemoteTaskEvent({
+            serverUrl,
+            taskId,
+            eventId: event.eventId,
+            envelopeId: envelope.envelopeId,
+            localSessionId: sender.portalSessionId,
+            localRouteId: localPresence.routeId,
+            remoteRouteId: target.routeId,
+            direction: "outbound",
+            kind: event.kind,
+            state: event.state,
+            payload: event,
+            senderLabel: localSessionLabel(this.#service, sender.portalSessionId),
+            senderReference: localPresence.routeId,
+            authenticated: false,
+            occurredAt: now,
+            expiresAt,
+        });
+        const acknowledgement = await this.#remote.sendEnvelope(serverUrl, envelope);
+        if (acknowledgement.status !== "received") {
+            await this.#sendInternalUpdate(record.task, sender.portalSessionId, {
+                action: "failed",
+                error: acknowledgement.error ?? "remote agent rejected the task offer",
+            }, false);
+            throw new Error(acknowledgement.error ?? "remote agent rejected the task offer");
+        }
+        return { delivery: "delivered", task: record.task, target: toCandidate(target), acknowledgement };
+    }
+    async update(localSessionId, taskId, update) {
+        this.#requireLocalSession(localSessionId);
+        const serverUrl = this.#requireServer(localSessionId);
+        const task = this.#service.index.repository.getRemoteTask(serverUrl, taskId);
+        if (task === null || task.localSessionId !== localSessionId)
+            throw new Error(`unknown remote task: ${taskId}`);
+        return this.#sendInternalUpdate(task, localSessionId, update, true);
+    }
+    async runnerCompleted(completion) {
+        if (!isRemoteEvent(completion) || completion.kind !== "offer")
+            return;
+        const task = this.#service.index.repository.getRemoteTask(completion.serverUrl, completion.taskId);
+        if (task === null || (task.state !== "accepted" && task.state !== "running"))
+            return;
+        await this.#sendInternalUpdate(task, completion.localSessionId, {
+            action: "completed",
+            result: completion.answer?.trim() || "Remote agent completed the task without a textual result.",
+        }, true);
+    }
+    async runnerFailed(completion) {
+        if (!isRemoteEvent(completion) || completion.kind !== "offer" || completion.deliveryState !== "failed")
+            return;
+        const task = this.#service.index.repository.getRemoteTask(completion.serverUrl, completion.taskId);
+        if (task === null || task.state === "declined" || task.state === "completed" || task.state === "failed")
+            return;
+        await this.#sendInternalUpdate(task, completion.localSessionId, {
+            action: "failed",
+            error: completion.error ?? "managed remote task turn failed",
+        }, true);
+    }
+    async #receive(serverUrl, envelope) {
+        const receivedAt = new Date();
+        const localSessionId = await this.#remote.localSessionForRoute(serverUrl, envelope.targetRouteId);
+        if (localSessionId === null) {
+            await this.#remote.acknowledge(serverUrl, {
+                targetRouteId: envelope.targetRouteId,
+                envelopeId: envelope.envelopeId,
+                eventId: envelope.event.eventId,
+                status: "rejected",
+                receivedAt: receivedAt.toISOString(),
+                error: "target route is not owned by a local managed session",
+            });
+            return;
+        }
+        try {
+            if (Date.parse(envelope.expiresAt) <= receivedAt.getTime())
+                throw new Error("remote task event has expired");
+            let peer = null;
+            try {
+                peer = await this.#remote.peerByRoute(serverUrl, envelope.senderRouteId);
+            }
+            catch {
+                // The routed envelope remains usable if presence changes after dispatch.
+            }
+            this.#service.index.repository.recordRemoteTaskEvent({
+                serverUrl,
+                taskId: envelope.event.taskId,
+                eventId: envelope.event.eventId,
+                envelopeId: envelope.envelopeId,
+                localSessionId,
+                localRouteId: envelope.targetRouteId,
+                remoteRouteId: envelope.senderRouteId,
+                direction: "inbound",
+                kind: envelope.event.kind,
+                state: envelope.event.state,
+                payload: envelope.event,
+                senderLabel: peer?.agentName ?? `remote-${envelope.senderRouteId}`,
+                senderReference: envelope.senderRouteId,
+                authenticated: false,
+                occurredAt: new Date(envelope.event.createdAt),
+                expiresAt: new Date(envelope.expiresAt),
+            });
+            await this.#remote.acknowledge(serverUrl, {
+                targetRouteId: envelope.targetRouteId,
+                envelopeId: envelope.envelopeId,
+                eventId: envelope.event.eventId,
+                status: "received",
+                receivedAt: receivedAt.toISOString(),
+            });
+        }
+        catch (error) {
+            await this.#remote.acknowledge(serverUrl, {
+                targetRouteId: envelope.targetRouteId,
+                envelopeId: envelope.envelopeId,
+                eventId: envelope.event.eventId,
+                status: "rejected",
+                receivedAt: receivedAt.toISOString(),
+                error: errorMessage(error).slice(0, 2_048),
+            });
+        }
+    }
+    async #sendInternalUpdate(task, localSessionId, update, send) {
+        if (task.localSessionId !== localSessionId)
+            throw new Error("remote task belongs to another local session");
+        const now = new Date();
+        if (task.expiresAt.getTime() <= now.getTime())
+            throw new Error("remote task has expired");
+        const event = taskEvent(task.taskId, update, now);
+        const envelope = createEnvelope(task.localRouteId, task.remoteRouteId, event, now, task.expiresAt);
+        const record = this.#service.index.repository.recordRemoteTaskEvent({
+            serverUrl: task.serverUrl,
+            taskId: task.taskId,
+            eventId: event.eventId,
+            envelopeId: envelope.envelopeId,
+            localSessionId,
+            localRouteId: task.localRouteId,
+            remoteRouteId: task.remoteRouteId,
+            direction: "outbound",
+            kind: event.kind,
+            state: event.state,
+            payload: event,
+            senderLabel: localSessionLabel(this.#service, localSessionId),
+            senderReference: task.localRouteId,
+            authenticated: false,
+            occurredAt: now,
+            expiresAt: task.expiresAt,
+        });
+        if (send) {
+            const acknowledgement = await this.#remote.sendEnvelope(task.serverUrl, envelope);
+            if (acknowledgement.status !== "received") {
+                throw new Error(acknowledgement.error ?? `remote agent rejected task event ${event.kind}`);
+            }
+        }
+        return record.event;
+    }
+    async #resolveCandidates(localSessionId, target) {
+        const routeLookup = target.startsWith("route_");
+        const sessionLookup = target.startsWith("ps_");
+        const peers = await this.#remote.discoverForSession(localSessionId, routeLookup || sessionLookup
+            ? { capability: "task", limit: 100 }
+            : { query: target, capability: "task", limit: 20 });
+        if (routeLookup)
+            return peers.filter(({ routeId }) => routeId === target);
+        if (sessionLookup)
+            return peers.filter(({ sessionId }) => sessionId === target);
+        const normalized = normalizeSessionReference(target);
+        return peers.filter(({ agentName }) => normalizeSessionReference(agentName) === normalized);
+    }
+    #requireLocalSession(sessionId) {
+        const session = this.#service.index.repository.getSession(sessionId);
+        if (session === null)
+            throw new Error(`unknown Portal session: ${sessionId}`);
+        return session;
+    }
+    #requireServer(sessionId) {
+        const serverUrl = this.#remote.serverForSession(sessionId);
+        if (serverUrl === null)
+            throw new Error("calling session is not connected to a remote Portal server");
+        return serverUrl;
+    }
+    async #requireLocalPresence(serverUrl, sessionId) {
+        const presence = await this.#remote.localRoute(serverUrl, sessionId);
+        if (presence === null)
+            throw new Error("calling session is not advertised on its Portal server");
+        return presence;
+    }
+}
+function createEnvelope(senderRouteId, targetRouteId, event, sentAt, expiresAt) {
+    return envelopeSchema.parse({
+        envelopeId: `envelope_${randomUUID()}`,
+        senderRouteId,
+        targetRouteId,
+        sentAt: sentAt.toISOString(),
+        expiresAt: expiresAt.toISOString(),
+        event,
+    });
+}
+function taskEvent(taskId, update, now) {
+    const base = { eventId: `event_${randomUUID()}`, taskId, createdAt: now.toISOString() };
+    switch (update.action) {
+        case "accepted": return { ...base, kind: "accepted", state: "accepted", ...(update.message === undefined ? {} : { message: update.message }) };
+        case "declined": return { ...base, kind: "declined", state: "declined", ...(update.reason === undefined ? {} : { reason: update.reason }) };
+        case "running": return { ...base, kind: "running", state: "running", ...(update.message === undefined ? {} : { message: update.message }) };
+        case "progress": return { ...base, kind: "progress", state: "running", message: update.message };
+        case "question": return { ...base, kind: "question", state: "running", question: update.question };
+        case "answer": return { ...base, kind: "answer", state: "running", answer: update.answer };
+        case "completed": return { ...base, kind: "completed", state: "completed", result: update.result, ...(update.artifactReferences === undefined ? {} : { artifactReferences: update.artifactReferences }) };
+        case "failed": return { ...base, kind: "failed", state: "failed", error: update.error };
+    }
+}
+function localSessionLabel(service, sessionId) {
+    const session = service.index.repository.getSession(sessionId);
+    const profile = service.index.repository.getSessionProfile(sessionId);
+    return profile?.displayName ?? session?.managedName ?? session?.title ?? session?.provider ?? "local-agent";
+}
+function toCandidate(peer) {
+    return {
+        routeId: peer.routeId,
+        agentName: peer.agentName,
+        description: peer.description,
+        state: peer.state,
+        authenticated: false,
+    };
+}
+function isRemoteEvent(value) {
+    return "eventId" in value && "serverUrl" in value;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=tasks.js.map

package/dist/src/network/tasks.js.map

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

package/dist/src/portal-index.d.ts

@@ -0,0 +1,21 @@
+import type { TranscriptEntry } from "./provider/types.js";
+import { type EmbeddingProvider } from "./recall/embedding.js";
+import type { RecallBundle, RecallOptions } from "./recall/types.js";
+import { PortalDatabase } from "./storage/database.js";
+import { PortalRepository, type IngestionResult, type SessionUpsert, type StoredSession } from "./storage/repository.js";
+export interface PortalIndexOptions {
+    databasePath: string;
+    embeddingProvider?: EmbeddingProvider;
+}
+/** Durable session inventory, transcript ingestion, and bounded hybrid recall. */
+export declare class PortalIndex {
+    readonly database: PortalDatabase;
+    readonly repository: PortalRepository;
+    readonly embeddingProvider: EmbeddingProvider;
+    constructor(options: PortalIndexOptions);
+    close(): void;
+    upsertSession(input: SessionUpsert): StoredSession;
+    ingestTranscript(portalSessionId: string, entries: readonly TranscriptEntry[]): Promise<IngestionResult>;
+    recall(query: string, options: RecallOptions): Promise<RecallBundle>;
+}
+export declare function redactSecrets(text: string): string;

package/dist/src/portal-index.js

@@ -0,0 +1,140 @@
+import { DeterministicFeatureHashEmbedding, } from "./recall/embedding.js";
+import { PortalDatabase } from "./storage/database.js";
+import { compileFtsQuery, PortalRepository, } from "./storage/repository.js";
+/** Durable session inventory, transcript ingestion, and bounded hybrid recall. */
+export class PortalIndex {
+    database;
+    repository;
+    embeddingProvider;
+    constructor(options) {
+        this.database = new PortalDatabase(options.databasePath);
+        this.repository = new PortalRepository(this.database);
+        this.embeddingProvider = options.embeddingProvider ?? new DeterministicFeatureHashEmbedding();
+    }
+    close() {
+        this.database.close();
+    }
+    upsertSession(input) {
+        return this.repository.upsertSession(input);
+    }
+    async ingestTranscript(portalSessionId, entries) {
+        const sanitized = entries.map((entry) => ({ ...entry, text: redactSecrets(entry.text) }));
+        const result = this.repository.ingestTranscript(portalSessionId, sanitized);
+        const missing = this.repository.chunksNeedingEmbedding(portalSessionId, this.embeddingProvider.id);
+        const embeddings = [];
+        for (let offset = 0; offset < missing.length; offset += 32) {
+            embeddings.push(...await Promise.all(missing.slice(offset, offset + 32).map(async (chunk) => ({
+                chunkId: chunk.chunkId,
+                vector: await this.embeddingProvider.embed(chunk.text),
+            }))));
+        }
+        for (const { vector } of embeddings) {
+            if (vector.length !== this.embeddingProvider.dimensions) {
+                throw new Error(`embedding provider ${this.embeddingProvider.id} returned ${vector.length} dimensions; expected ${this.embeddingProvider.dimensions}`);
+            }
+        }
+        this.repository.saveEmbeddings(this.embeddingProvider.id, embeddings);
+        this.repository.markSessionIndexed(portalSessionId);
+        return result;
+    }
+    async recall(query, options) {
+        if (options.workspace.length === 0)
+            throw new TypeError("recall requires a non-empty workspace");
+        const limit = clampInteger(options.limit ?? 5, 1, 50, "limit");
+        const maxPerSession = clampInteger(options.maxPerSession ?? Math.min(2, limit), 1, limit, "maxPerSession");
+        const candidateLimit = clampInteger(options.candidateLimit ?? Math.max(limit * 8, 40), limit, 500, "candidateLimit");
+        const candidateQuery = {
+            workspace: options.workspace,
+            ...(options.providers === undefined ? {} : { providers: options.providers }),
+            ...(options.occurredAfter === undefined ? {} : { occurredAfter: options.occurredAfter }),
+            ...(options.occurredBefore === undefined ? {} : { occurredBefore: options.occurredBefore }),
+            limit: candidateLimit,
+        };
+        const lexical = this.repository.lexicalCandidates(compileFtsQuery(query), candidateQuery);
+        const vector = await this.embeddingProvider.embed(query);
+        if (vector.length !== this.embeddingProvider.dimensions) {
+            throw new Error(`embedding provider ${this.embeddingProvider.id} returned ${vector.length} dimensions; expected ${this.embeddingProvider.dimensions}`);
+        }
+        const semantic = this.repository.semanticCandidates(this.embeddingProvider.id, vector, candidateQuery);
+        const candidates = new Map();
+        for (let index = 0; index < lexical.length; index += 1) {
+            const candidate = lexical[index];
+            if (candidate === undefined)
+                continue;
+            candidates.set(candidate.chunkId, {
+                chunkId: candidate.chunkId,
+                excerpt: candidate.text,
+                portalSessionId: candidate.citation.portalSessionId,
+                citation: candidate.citation,
+                score: 1 / (60 + index + 1),
+                lexicalScore: 1 / (1 + Math.abs(candidate.lexicalRank)),
+                semanticScore: null,
+            });
+        }
+        for (let index = 0; index < semantic.length; index += 1) {
+            const candidate = semantic[index];
+            if (candidate === undefined)
+                continue;
+            const current = candidates.get(candidate.chunkId);
+            if (current === undefined) {
+                candidates.set(candidate.chunkId, {
+                    chunkId: candidate.chunkId,
+                    excerpt: candidate.text,
+                    portalSessionId: candidate.citation.portalSessionId,
+                    citation: candidate.citation,
+                    score: 0.9 / (60 + index + 1),
+                    lexicalScore: null,
+                    semanticScore: candidate.similarity,
+                });
+            }
+            else {
+                current.score += 0.9 / (60 + index + 1);
+                current.semanticScore = candidate.similarity;
+            }
+        }
+        const ranked = [...candidates.values()].sort((left, right) => right.score - left.score || left.chunkId.localeCompare(right.chunkId));
+        const sessionCounts = new Map();
+        const evidence = [];
+        for (const candidate of ranked) {
+            const count = sessionCounts.get(candidate.portalSessionId) ?? 0;
+            if (count >= maxPerSession)
+                continue;
+            sessionCounts.set(candidate.portalSessionId, count + 1);
+            evidence.push({
+                chunkId: candidate.chunkId,
+                excerpt: candidate.excerpt,
+                score: candidate.score,
+                lexicalScore: candidate.lexicalScore,
+                semanticScore: candidate.semanticScore,
+                citation: candidate.citation,
+            });
+            if (evidence.length === limit)
+                break;
+        }
+        return {
+            query,
+            workspace: options.workspace,
+            evidence,
+            truncated: ranked.length > evidence.length,
+            indexFreshness: this.repository.workspaceFreshness(options.workspace),
+        };
+    }
+}
+const SECRET_PATTERNS = [
+    /-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z ]*PRIVATE KEY-----/g,
+    /\b(?:sk-(?:proj-)?|sk-ant-)[A-Za-z0-9_-]{16,}\b/g,
+    /\b(?:ghp|github_pat)_[A-Za-z0-9_]{20,}\b/g,
+    /\bAKIA[0-9A-Z]{16}\b/g,
+    /\bBearer\s+[A-Za-z0-9._~+\/-]{16,}=*/gi,
+    /\b(?:API_KEY|ACCESS_TOKEN|AUTH_TOKEN|SECRET_KEY|PASSWORD)\s*[=:]\s*[^\s,;]+/gi,
+];
+export function redactSecrets(text) {
+    return SECRET_PATTERNS.reduce((value, pattern) => value.replace(pattern, "[REDACTED_SECRET]"), text);
+}
+function clampInteger(value, minimum, maximum, name) {
+    if (!Number.isInteger(value) || value < minimum || value > maximum) {
+        throw new RangeError(`${name} must be an integer between ${minimum} and ${maximum}`);
+    }
+    return value;
+}
+//# sourceMappingURL=portal-index.js.map

package/dist/src/portal-index.js.map

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

package/dist/src/provider/claude-managed.d.ts

@@ -0,0 +1,34 @@
+import type { Options, SDKMessage, SDKUserMessage } from "@anthropic-ai/claude-agent-sdk";
+export type ClaudeManagedState = "launching" | "active" | "idle" | "requires_action" | "closed";
+export interface ClaudeManagedSessionStatus {
+    vendorSessionId: string | null;
+    state: ClaudeManagedState;
+    connected: boolean;
+    messageable: boolean;
+}
+export interface ClaudeManagedSessionOptions {
+    cwd: string;
+    /** Optional caller-minted UUID for stable identity before the init event. */
+    sessionId?: string;
+}
+export interface ClaudeManagedQuery extends AsyncIterable<SDKMessage> {
+    close(): void;
+    interrupt(): Promise<unknown>;
+}
+export type ClaudeManagedQueryFactory = (params: {
+    prompt: AsyncIterable<SDKUserMessage>;
+    options: Pick<Options, "cwd" | "persistSession" | "sessionId">;
+}) => ClaudeManagedQuery;
+/**
+ * A live handle only for a Claude process Portal launches and keeps attached.
+ * It does not attach to, or prove liveness for, independently launched sessions.
+ */
+export declare class ClaudeManagedSession {
+    #private;
+    constructor(options: ClaudeManagedSessionOptions, queryFactory?: ClaudeManagedQueryFactory);
+    get status(): Readonly<ClaudeManagedSessionStatus>;
+    send(text: string): string;
+    interrupt(): Promise<void>;
+    close(): void;
+    events(): AsyncGenerator<SDKMessage, void>;
+}

package/dist/src/provider/claude-managed.js

@@ -0,0 +1,125 @@
+import { randomUUID } from "node:crypto";
+import { query } from "@anthropic-ai/claude-agent-sdk";
+const defaultQueryFactory = (params) => query(params);
+class AsyncInputQueue {
+    #pending = [];
+    #waiters = [];
+    #ended = false;
+    push(message) {
+        if (this.#ended)
+            throw new Error("Claude managed session input is closed");
+        const waiter = this.#waiters.shift();
+        if (waiter)
+            waiter({ done: false, value: message });
+        else
+            this.#pending.push(message);
+    }
+    end() {
+        if (this.#ended)
+            return;
+        this.#ended = true;
+        for (const waiter of this.#waiters.splice(0))
+            waiter({ done: true, value: undefined });
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: () => {
+                const message = this.#pending.shift();
+                if (message)
+                    return Promise.resolve({ done: false, value: message });
+                if (this.#ended)
+                    return Promise.resolve({ done: true, value: undefined });
+                return new Promise((resolve) => this.#waiters.push(resolve));
+            },
+        };
+    }
+}
+/**
+ * A live handle only for a Claude process Portal launches and keeps attached.
+ * It does not attach to, or prove liveness for, independently launched sessions.
+ */
+export class ClaudeManagedSession {
+    #input = new AsyncInputQueue();
+    #query;
+    #eventsClaimed = false;
+    #status;
+    constructor(options, queryFactory = defaultQueryFactory) {
+        this.#status = {
+            vendorSessionId: options.sessionId ?? null,
+            state: "launching",
+            connected: false,
+            messageable: true,
+        };
+        this.#query = queryFactory({
+            prompt: this.#input,
+            options: {
+                cwd: options.cwd,
+                persistSession: true,
+                ...(options.sessionId === undefined ? {} : { sessionId: options.sessionId }),
+            },
+        });
+    }
+    get status() {
+        return { ...this.#status };
+    }
+    send(text) {
+        if (!this.#status.messageable)
+            throw new Error("Claude managed session is not messageable");
+        if (text.trim().length === 0)
+            throw new Error("Claude managed session input cannot be empty");
+        const uuid = randomUUID();
+        this.#input.push({
+            type: "user",
+            message: { role: "user", content: text },
+            parent_tool_use_id: null,
+            timestamp: new Date().toISOString(),
+            uuid,
+        });
+        return uuid;
+    }
+    async interrupt() {
+        if (this.#status.state === "closed")
+            return;
+        await this.#query.interrupt();
+    }
+    close() {
+        if (this.#status.state === "closed")
+            return;
+        this.#input.end();
+        this.#query.close();
+        this.#markClosed();
+    }
+    async *events() {
+        if (this.#eventsClaimed)
+            throw new Error("Claude managed session events can only be consumed once");
+        this.#eventsClaimed = true;
+        try {
+            for await (const event of this.#query) {
+                this.#status = { ...this.#status, connected: true };
+                if (event.type === "system" && event.subtype === "init") {
+                    this.#status = { ...this.#status, vendorSessionId: event.session_id, state: "active" };
+                }
+                else if (event.type === "system" && event.subtype === "session_state_changed") {
+                    this.#status = {
+                        ...this.#status,
+                        state: event.state === "running" ? "active" : event.state,
+                    };
+                }
+                yield event;
+            }
+        }
+        finally {
+            this.#input.end();
+            this.#markClosed();
+        }
+    }
+    #markClosed() {
+        this.#status = {
+            ...this.#status,
+            state: "closed",
+            connected: false,
+            messageable: false,
+        };
+    }
+}
+//# sourceMappingURL=claude-managed.js.map

package/dist/src/provider/claude-managed.js.map

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