@grackle-ai/adapter-sdk 0.132.2 → 0.133.0

package/dist/grpc-host-transport.js

@@ -1,168 +0,0 @@
-/**
- * gRPC-backed implementation of {@link IHostTransport} (AHP HR8c).
- *
- * Wraps a {@link PowerLineClient} (ConnectRPC client) and folds each
- * incoming `AgentEvent` through the {@link mapAgentEvent} mapper to produce
- * AHP `StateAction[]`. Per-session {@link MapperContext} state is kept inside
- * this instance so consumers don't need to thread it through their code.
- *
- * @module grpc-host-transport
- */
-import { create } from "@bufbuild/protobuf";
-import { powerline, mapAgentEvent } from "@grackle-ai/common";
-/**
- * gRPC-backed {@link IHostTransport} for a single environment.
- *
- * Lifecycle: one instance per `PowerLineConnection`. The mapper context map
- * is keyed by session URI so multiple sessions on the same environment each
- * get their own turn/tool tracking.
- */
-export class GrpcHostTransport {
-    /** Underlying ConnectRPC client for the PowerLine gRPC service. */
-    client;
-    /**
-     * Per-session mapper context. Created lazily on first event per session;
-     * cleaned up when the session's stream completes or errors.
-     */
-    mapperContexts = new Map();
-    /**
-     * Create a new gRPC-backed host transport.
-     *
-     * @param client - The ConnectRPC client to wrap. Typically obtained from
-     *   {@link createPowerLineClient} or a `PowerLineConnection`.
-     */
-    constructor(client) {
-        this.client = client;
-    }
-    /**
-     * Create a new session via PowerLine's `spawn` RPC.
-     *
-     * Returns the session URI plus a live stream of {@link ServerActionEnvelope}s.
-     * The stream is mapped from the underlying `AgentEvent` stream.
-     */
-    createSession(params) {
-        const spawnReq = create(powerline.SpawnRequestSchema, {
-            sessionId: params.sessionId,
-            runtime: params.runtime,
-            prompt: params.prompt,
-            model: params.model,
-            maxTurns: params.maxTurns,
-            branch: params.branch,
-            workingDirectory: params.workingDirectory,
-            systemContext: params.systemContext,
-            workspaceId: params.workspaceId,
-            taskId: params.taskId,
-            mcpServersJson: params.mcpServersJson,
-            mcpUrl: params.mcpUrl,
-            mcpToken: params.mcpToken,
-            useWorktrees: params.useWorktrees,
-            pipe: params.pipe ?? "",
-            scriptContent: params.scriptContent ?? "",
-        });
-        const grpcStream = this.client.spawn(spawnReq);
-        return {
-            sessionUri: params.sessionId,
-            stream: this.foldStream(params.sessionId, grpcStream),
-        };
-    }
-    /**
-     * Reanimate a suspended session via PowerLine's `resume` RPC.
-     *
-     * Returns a live stream of envelopes for the reanimated session. Note that
-     * `resume` alone does NOT replay buffered events — call
-     * {@link IHostTransport.drainBuffered} first to replay the parked queue,
-     * then this method to start the live stream.
-     */
-    reanimate(params) {
-        const resumeReq = create(powerline.ResumeRequestSchema, {
-            sessionId: params.sessionId,
-            runtimeSessionId: params.runtimeSessionId,
-            runtime: params.runtime,
-        });
-        const grpcStream = this.client.resume(resumeReq);
-        return this.foldStream(params.sessionId, grpcStream);
-    }
-    /**
-     * Drain previously-parked buffered events for a session.
-     *
-     * Maps to the gRPC `drainBufferedEvents` RPC. The returned stream yields
-     * the buffered envelopes and then terminates — it does NOT continue into
-     * the live event stream. Callers compose `drainBuffered` + `reanimate`
-     * to do recovery.
-     */
-    async *drainBuffered(sessionUri) {
-        const drainReq = create(powerline.DrainRequestSchema, {
-            sessionId: sessionUri,
-        });
-        const drainStream = this.client.drainBufferedEvents(drainReq);
-        yield* this.foldStream(sessionUri, drainStream);
-    }
-    /** Send input text to a session via PowerLine's `sendInput` RPC. */
-    async dispatchInput(sessionUri, text) {
-        await this.client.sendInput(create(powerline.InputMessageSchema, { sessionId: sessionUri, text }));
-    }
-    /** Authenticate credentials via PowerLine's `authenticate` RPC. */
-    async authenticate(params) {
-        await this.client.authenticate(create(powerline.AuthenticateRequestSchema, {
-            provider: params.provider,
-            tokens: params.tokens.map((t) => create(powerline.TokenItemSchema, {
-                name: t.name,
-                type: t.type,
-                envVar: t.envVar ?? "",
-                filePath: t.filePath ?? "",
-                value: t.value,
-            })),
-        }));
-    }
-    /** Dispose a session via PowerLine's `kill` RPC. */
-    async dispose(sessionUri, reason) {
-        await this.client.kill(create(powerline.KillRequestSchema, { id: sessionUri, reason: reason ?? "" }));
-        this.mapperContexts.delete(sessionUri);
-    }
-    /** List active sessions via PowerLine's `listSessions` RPC. */
-    async listSessions() {
-        const list = await this.client.listSessions({});
-        return list.sessions.map((s) => ({
-            sessionId: s.sessionId,
-            runtime: s.runtime,
-            status: s.status,
-        }));
-    }
-    /**
-     * Fold a raw `AgentEvent` stream into `ServerActionEnvelope`s by running
-     * each event through the mapper. The per-session `MapperContext` is
-     * created/retrieved lazily and removed when the stream completes.
-     */
-    async *foldStream(sessionUri, grpcStream) {
-        const context = this.getOrCreateContext(sessionUri);
-        try {
-            for await (const event of grpcStream) {
-                const idx = context.eventIndex++;
-                const { actions } = mapAgentEvent(event, idx, context);
-                yield { event, actions };
-            }
-        }
-        finally {
-            // Context lifetime tracks the stream; recover paths create a fresh one
-            // on the next drainBuffered/reanimate. Clearing here prevents memory
-            // growth for sessions that close cleanly.
-            this.mapperContexts.delete(sessionUri);
-        }
-    }
-    /** Get an existing or create a fresh `MapperContext` for a session. */
-    getOrCreateContext(sessionUri) {
-        let ctx = this.mapperContexts.get(sessionUri);
-        if (!ctx) {
-            ctx = {
-                turnId: undefined,
-                openToolCalls: [],
-                partCounter: 0,
-                eventIndex: 0,
-                metaAccumulator: {},
-            };
-            this.mapperContexts.set(sessionUri, ctx);
-        }
-        return ctx;
-    }
-}
-//# sourceMappingURL=grpc-host-transport.js.map

package/dist/grpc-host-transport.js.map

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