@pinagent/react-native 0.1.0

package/dist/server.d.cts

@@ -0,0 +1,109 @@
+import { IncomingMessage, Server, ServerResponse } from "node:http";
+import { WebSocketServer } from "ws";
+
+//#region ../agent-runner/dist/index.d.ts
+//#endregion
+//#region src/agent-permission.d.ts
+type SpawnAgentMode = 'worktree' | 'inline' | false;
+/**
+ * Resolve the spawn mode from env. The new default (V2) is `'inline'` —
+ * SDK-backed per-submit agent with streaming back to the widget. Worktree
+ * mode is opt-in; `'off'` (or the legacy `'false'`) disables spawning so
+ * channel-mode / pull-mode setups don't get a redundant agent per submit.
+ */
+/**
+ * Build a `noServer` WebSocket endpoint to hand to a host that owns its own
+ * HTTP server and routes the `upgrade` event by pathname — notably Metro's
+ * `config.server.websocketEndpoints` (React Native / Expo).
+ *
+ * Unlike {@link startWsServer}, this binds no port: the caller's dev server
+ * (Metro) already listens, performs the HTTP upgrade, and dispatches matching
+ * requests here via `handleUpgrade`. That means RN streaming rides the *same*
+ * host:port the widget already talks to for `POST /__pinagent/feedback`, so a
+ * physical device needs no second port and no port discovery.
+ *
+ * Each accepted socket is wired to the same {@link attachConnection} the web
+ * path uses — identical wire protocol, bus subscription, and worktree
+ * controls. We also start the project-event fan-out and relay (idempotent,
+ * singleton-guarded) so worktree Land/Discard and cloud mode behave the same.
+ */
+declare function createPinagentWsEndpoint(): WebSocketServer;
+//#endregion
+//#region src/server/metro-middleware.d.ts
+type Handler = (req: IncomingMessage, res: ServerResponse, next: () => void) => void;
+interface PinagentMiddlewareOpts {
+  /** Project root — where `.pinagent/` lives. Pass `__dirname`. */
+  projectRoot: string;
+  /**
+   * Agent spawn mode, same semantics as the Vite plugin:
+   * `false` (file only), `'inline'`, or `'worktree'`. Defaults to
+   * `'inline'`.
+   */
+  spawnMode?: SpawnAgentMode;
+  /**
+   * Optional explicit API key for spawned agent runs, same semantics as the
+   * Vite plugin's `apiKey`.
+   *
+   * Pinagent never reads `ANTHROPIC_API_KEY` / `OPENAI_API_KEY` from the
+   * environment on its own — a key exported in your shell for other tools must
+   * not get billed (or, if stale, fail the run with "Invalid API key") just
+   * because pinagent happened to inherit it. When you leave this unset, runs
+   * authenticate against your agentic subscription (Claude Code, or Codex's
+   * ChatGPT login when using the CLI provider).
+   *
+   * Set it only when you deliberately want a raw key used, e.g.
+   * `pinagentMiddleware({ projectRoot: __dirname, apiKey: process.env.MY_KEY })`.
+   * For the default Claude provider it's passed as the Anthropic key; for the
+   * bring-your-own CLI provider it's supplied to the wrapped CLI as both
+   * `ANTHROPIC_API_KEY` and `OPENAI_API_KEY`. Bridged to the runner via the
+   * `PINAGENT_AGENT_API_KEY` env var (RN has no dock, so the option/env is the
+   * whole story — there's no runtime Connections store to take precedence).
+   */
+  apiKey?: string;
+}
+interface PinagentMiddleware {
+  (req: IncomingMessage, res: ServerResponse, next: () => void): void;
+  /** Compose: run pinagent routes first, then `next` for everything else. */
+  chain(next: Handler): Handler;
+}
+declare function pinagentMiddleware(opts: PinagentMiddlewareOpts): PinagentMiddleware;
+//#endregion
+//#region src/server/ws-endpoint.d.ts
+interface PinagentWsEndpointsOpts {
+  /**
+   * Project root — where `.pinagent/` lives. Pass `__dirname`, the same value
+   * given to `pinagentMiddleware`. The agent run records events keyed on this
+   * root; the WS server's bus subscription otherwise resolves the root from
+   * `PINAGENT_PROJECT_ROOT` (falling back to `process.cwd()`). Metro's cwd is
+   * usually the project dir, but we pin the env var so streaming always reads
+   * the same `.pinagent/db.sqlite` the feedback middleware writes to.
+   */
+  projectRoot: string;
+}
+/**
+ * Returns the `{ [path]: ws.Server }` map to spread into Metro's
+ * `config.server.websocketEndpoints`. Mounts the Pinagent stream at
+ * `/__pinagent/ws`.
+ */
+declare function pinagentWebsocketEndpoints(opts: PinagentWsEndpointsOpts): Record<string, ReturnType<typeof createPinagentWsEndpoint>>;
+/**
+ * Idempotently mount `/__pinagent/ws` on a live HTTP server, regardless of
+ * whether the host honors `config.server.websocketEndpoints`.
+ *
+ * Expo's dev server registers a single `upgrade` listener that destroys any
+ * path it doesn't know, so simply *adding* a second listener races with that
+ * destroy. Instead we take the listener over: capture whatever `upgrade`
+ * listeners are already attached (Metro's `/hot`, Expo's devtools/debugger
+ * sockets, …), remove them, and install one router that handles
+ * `/__pinagent/ws` itself and delegates every other path back to the captured
+ * listeners untouched. HMR and the rest keep working; our path no longer gets
+ * destroyed out from under us.
+ *
+ * Called lazily from `pinagentMiddleware` with `req.socket.server` — by the
+ * time any HTTP request reaches the middleware the dev server is listening and
+ * its own `upgrade` listener is already registered, so the capture is complete.
+ */
+declare function ensurePinagentUpgrade(server: Server): void;
+//#endregion
+export { type PinagentMiddleware, type PinagentMiddlewareOpts, type PinagentWsEndpointsOpts, ensurePinagentUpgrade, pinagentMiddleware, pinagentWebsocketEndpoints };
+//# sourceMappingURL=server.d.cts.map

package/dist/server.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.cts","names":["z","ZodObject","baseBranch","ZodString","worktreeRetentionDays","ZodNumber","perConversationCapUsd","monthlyBudgetUsd","ZodNullable","permissionMode","ZodEnum","auto","approve","allowedBranchPatterns","ZodArray","core","$strip","infer","ProjectSettingsSchema","ZodOptional","ProjectSettingsPatchSchema","ProjectSettings","projectRoot","constructor","path","read","Promise","patch","ProjectSettingsPatch","NodeJS","ProcessEnv","env","SpawnAgentMode","PermissionMode$1","PermissionMode","mode","RegExp","file","line","col","selector","clickX","clickY","component","AdditionalAnchorSchema","comment","loc","url","viewport","w","h","userAgent","screenshot","createdAt","additionalAnchors","componentPath","instance","index","total","fingerprint","FeedbackInputSchema","pending","fixed","wontfix","deferred","StatusSchema","none","active","landed","discarded","WorktreeStateSchema","id","AdditionalAnchor","instanceIndex","instanceTotal","instanceFingerprint","status","Status","note","commitSha","agentSessionId","branch","worktreePath","worktreeState","WorktreeState","title","archived","updatedAt","resolvedAt","messageCount","totalCostUsd","apiKeySource","isRunning","ZodBoolean","PatchSchema","root","feedbackDir","screenshotsDir","legacyImportDone","db","ensureDirs","maybeImportLegacy","insertRecord","create","FeedbackInput","input","FeedbackRecord","list","readApiKeySource","computeConversationCost","computeMonthlySpend","Date","month","listMessages","AgentEvent","readScreenshotBase64","rec","patchWithDiff","Patch","record","previousStatus","atomicWriteBytes","target","ok","conflicts","error","feedbackId","logPath","LandResult","reopened","failed","feedbackIds","BulkReopenResult","filesChanged","additions","deletions","baseRef","WorktreeStats","diff","truncated","WorktreeDiff","feedback","AgentContext","ctx","content","McpSdkServerConfigWithInstance","askId","answer","reason","conversationId","actor","AuditActor","action","AuditAction","payload","Record","limit","offset","RecordAuditEventInput","ListAuditEventsOpts","opts","AuditEventRecord","name","conversationTitle","lastActivity","state","diskMb","BranchRecord","PruneResult","port","reused","ServeBranchResult","pruned","retentionDays","BulkPruneBodySchema","BulkPruneResult","PruneStaleResult","publish","event","subscribe","BusSubscriber","sub","markFinished","SqliteEventBus","externallyModified","preview","ChangeRecord","login","token","GithubValidation","key","AnthropicValidation","ids","BulkUpdateBodySchema","BulkReopenBodySchema","ApplyPatchResult","updated","skipped","BulkArchiveResult","editor","command","OpenInEditorResult","dir","isDir","entries","FileEntry","query","ListFilesResult","stdout","cwd","HistoryStatusFilter","matchedFields","MatchedField","snippet","HistorySearchOpts","HistorySearchHit","branchName","description","prUrl","branchPushed","manualCompareUrl","files","ComposeOpts","ComposeResult","targetFile","prompt","isInitial","AgentPermissionMode","resume","abortSignal","AbortSignal","events","log","sessionId","isResult","resultFooter","run","AgentRunRequest","req","AsyncIterable","ProviderRunItem","AgentProvider","ProviderId","number","body","conversationIds","PullRequestRecord","minBackoffMs","maxBackoffMs","connect","WebSocket","attach","socket","schedule","fn","ms","msg","close","origin","attempt","min","max","RelayClientOptions","RelayClientHandle","ZodDefault","github","anthropic","SecretsFileSchema","connected","keySet","SecretsFile","Partial","setGithub","clearGithub","setAnthropic","clearAnthropic","getGithubToken","getAnthropicKey","presentable","PresentableConnections","text","PrSummary","added","deleted","WorkingCopyFileStatus","isDefaultBranch","WorkingCopyFile","ahead","behind","hasUpstream","dirty","pr","WorkingCopyPrRef","WorkingCopyStatus","WorktreeServerInfo","override","args","ServeResult","wss","WebSocketServer","httpServer","Server","ServerHandle"],"sources":["../../agent-runner/dist/index.d.ts","../src/server/metro-middleware.ts","../src/server/ws-endpoint.ts"],"mappings":";;;;;;KA4CK,cAAA;;;;;;;;;;;;;;;;;;;;;;;iBAi2CY,wBAAA,IAA4B,eAAe;;;KCr2CvD,OAAA,IAAW,GAAA,EAAK,eAAA,EAAiB,GAAA,EAAK,cAAc,EAAE,IAAA;AAAA,UAE1C,sBAAA;;EAEf,WAAA;EDAG;;;;AAAc;ECMjB,SAAA,GAAY,cAAc;ED21Ca;;;AAAmB;;;;AC32C5B;;;;;;;;;;AAM2C;AAE3E;EA4BE,MAAA;AAAA;AAAA,UAGe,kBAAA;EAAA,CACd,GAAA,EAAK,eAAA,EAAiB,GAAA,EAAK,cAAA,EAAgB,IAAA;EAxB5C;EA0BA,KAAA,CAAM,IAAA,EAAM,OAAA,GAAU,OAAA;AAAA;AAAA,iBAGR,kBAAA,CAAmB,IAAA,EAAM,sBAAA,GAAyB,kBAAkB;;;UChCnE,uBAAA;ED6BH;;;;;;;;ECpBZ,WAAW;AAAA;;;;;ADoBkB;iBCZf,0BAAA,CACd,IAAA,EAAM,uBAAA,GACL,MAAA,SAAe,UAAA,QAAkB,wBAAA;;;;;;;;ADagD;;;;AChCpF;;;;AASa;AAQb;iBA+BgB,qBAAA,CAAsB,MAAc,EAAN,MAAM"}

package/dist/server.d.ts

@@ -0,0 +1,110 @@
+import { z } from "zod";
+import { WebSocket, WebSocketServer } from "ws";
+import { IncomingMessage, Server, ServerResponse } from "node:http";
+
+//#region ../agent-runner/dist/index.d.ts
+//#endregion
+//#region src/agent-permission.d.ts
+type SpawnAgentMode = 'worktree' | 'inline' | false;
+/**
+ * Resolve the spawn mode from env. The new default (V2) is `'inline'` —
+ * SDK-backed per-submit agent with streaming back to the widget. Worktree
+ * mode is opt-in; `'off'` (or the legacy `'false'`) disables spawning so
+ * channel-mode / pull-mode setups don't get a redundant agent per submit.
+ */
+/**
+ * Build a `noServer` WebSocket endpoint to hand to a host that owns its own
+ * HTTP server and routes the `upgrade` event by pathname — notably Metro's
+ * `config.server.websocketEndpoints` (React Native / Expo).
+ *
+ * Unlike {@link startWsServer}, this binds no port: the caller's dev server
+ * (Metro) already listens, performs the HTTP upgrade, and dispatches matching
+ * requests here via `handleUpgrade`. That means RN streaming rides the *same*
+ * host:port the widget already talks to for `POST /__pinagent/feedback`, so a
+ * physical device needs no second port and no port discovery.
+ *
+ * Each accepted socket is wired to the same {@link attachConnection} the web
+ * path uses — identical wire protocol, bus subscription, and worktree
+ * controls. We also start the project-event fan-out and relay (idempotent,
+ * singleton-guarded) so worktree Land/Discard and cloud mode behave the same.
+ */
+declare function createPinagentWsEndpoint(): WebSocketServer;
+//#endregion
+//#region src/server/metro-middleware.d.ts
+type Handler = (req: IncomingMessage, res: ServerResponse, next: () => void) => void;
+interface PinagentMiddlewareOpts {
+  /** Project root — where `.pinagent/` lives. Pass `__dirname`. */
+  projectRoot: string;
+  /**
+   * Agent spawn mode, same semantics as the Vite plugin:
+   * `false` (file only), `'inline'`, or `'worktree'`. Defaults to
+   * `'inline'`.
+   */
+  spawnMode?: SpawnAgentMode;
+  /**
+   * Optional explicit API key for spawned agent runs, same semantics as the
+   * Vite plugin's `apiKey`.
+   *
+   * Pinagent never reads `ANTHROPIC_API_KEY` / `OPENAI_API_KEY` from the
+   * environment on its own — a key exported in your shell for other tools must
+   * not get billed (or, if stale, fail the run with "Invalid API key") just
+   * because pinagent happened to inherit it. When you leave this unset, runs
+   * authenticate against your agentic subscription (Claude Code, or Codex's
+   * ChatGPT login when using the CLI provider).
+   *
+   * Set it only when you deliberately want a raw key used, e.g.
+   * `pinagentMiddleware({ projectRoot: __dirname, apiKey: process.env.MY_KEY })`.
+   * For the default Claude provider it's passed as the Anthropic key; for the
+   * bring-your-own CLI provider it's supplied to the wrapped CLI as both
+   * `ANTHROPIC_API_KEY` and `OPENAI_API_KEY`. Bridged to the runner via the
+   * `PINAGENT_AGENT_API_KEY` env var (RN has no dock, so the option/env is the
+   * whole story — there's no runtime Connections store to take precedence).
+   */
+  apiKey?: string;
+}
+interface PinagentMiddleware {
+  (req: IncomingMessage, res: ServerResponse, next: () => void): void;
+  /** Compose: run pinagent routes first, then `next` for everything else. */
+  chain(next: Handler): Handler;
+}
+declare function pinagentMiddleware(opts: PinagentMiddlewareOpts): PinagentMiddleware;
+//#endregion
+//#region src/server/ws-endpoint.d.ts
+interface PinagentWsEndpointsOpts {
+  /**
+   * Project root — where `.pinagent/` lives. Pass `__dirname`, the same value
+   * given to `pinagentMiddleware`. The agent run records events keyed on this
+   * root; the WS server's bus subscription otherwise resolves the root from
+   * `PINAGENT_PROJECT_ROOT` (falling back to `process.cwd()`). Metro's cwd is
+   * usually the project dir, but we pin the env var so streaming always reads
+   * the same `.pinagent/db.sqlite` the feedback middleware writes to.
+   */
+  projectRoot: string;
+}
+/**
+ * Returns the `{ [path]: ws.Server }` map to spread into Metro's
+ * `config.server.websocketEndpoints`. Mounts the Pinagent stream at
+ * `/__pinagent/ws`.
+ */
+declare function pinagentWebsocketEndpoints(opts: PinagentWsEndpointsOpts): Record<string, ReturnType<typeof createPinagentWsEndpoint>>;
+/**
+ * Idempotently mount `/__pinagent/ws` on a live HTTP server, regardless of
+ * whether the host honors `config.server.websocketEndpoints`.
+ *
+ * Expo's dev server registers a single `upgrade` listener that destroys any
+ * path it doesn't know, so simply *adding* a second listener races with that
+ * destroy. Instead we take the listener over: capture whatever `upgrade`
+ * listeners are already attached (Metro's `/hot`, Expo's devtools/debugger
+ * sockets, …), remove them, and install one router that handles
+ * `/__pinagent/ws` itself and delegates every other path back to the captured
+ * listeners untouched. HMR and the rest keep working; our path no longer gets
+ * destroyed out from under us.
+ *
+ * Called lazily from `pinagentMiddleware` with `req.socket.server` — by the
+ * time any HTTP request reaches the middleware the dev server is listening and
+ * its own `upgrade` listener is already registered, so the capture is complete.
+ */
+declare function ensurePinagentUpgrade(server: Server): void;
+//#endregion
+export { type PinagentMiddleware, type PinagentMiddlewareOpts, type PinagentWsEndpointsOpts, ensurePinagentUpgrade, pinagentMiddleware, pinagentWebsocketEndpoints };
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","names":["z","ZodObject","baseBranch","ZodString","worktreeRetentionDays","ZodNumber","perConversationCapUsd","monthlyBudgetUsd","ZodNullable","permissionMode","ZodEnum","auto","approve","allowedBranchPatterns","ZodArray","core","$strip","infer","ProjectSettingsSchema","ZodOptional","ProjectSettingsPatchSchema","ProjectSettings","projectRoot","constructor","path","read","Promise","patch","ProjectSettingsPatch","NodeJS","ProcessEnv","env","SpawnAgentMode","PermissionMode$1","PermissionMode","mode","RegExp","file","line","col","selector","clickX","clickY","component","AdditionalAnchorSchema","comment","loc","url","viewport","w","h","userAgent","screenshot","createdAt","additionalAnchors","componentPath","instance","index","total","fingerprint","FeedbackInputSchema","pending","fixed","wontfix","deferred","StatusSchema","none","active","landed","discarded","WorktreeStateSchema","id","AdditionalAnchor","instanceIndex","instanceTotal","instanceFingerprint","status","Status","note","commitSha","agentSessionId","branch","worktreePath","worktreeState","WorktreeState","title","archived","updatedAt","resolvedAt","messageCount","totalCostUsd","apiKeySource","isRunning","ZodBoolean","PatchSchema","root","feedbackDir","screenshotsDir","legacyImportDone","db","ensureDirs","maybeImportLegacy","insertRecord","create","FeedbackInput","input","FeedbackRecord","list","readApiKeySource","computeConversationCost","computeMonthlySpend","Date","month","listMessages","AgentEvent","readScreenshotBase64","rec","patchWithDiff","Patch","record","previousStatus","atomicWriteBytes","target","ok","conflicts","error","feedbackId","logPath","LandResult","reopened","failed","feedbackIds","BulkReopenResult","filesChanged","additions","deletions","baseRef","WorktreeStats","diff","truncated","WorktreeDiff","feedback","AgentContext","ctx","content","McpSdkServerConfigWithInstance","askId","answer","reason","conversationId","actor","AuditActor","action","AuditAction","payload","Record","limit","offset","RecordAuditEventInput","ListAuditEventsOpts","opts","AuditEventRecord","name","conversationTitle","lastActivity","state","diskMb","BranchRecord","PruneResult","port","reused","ServeBranchResult","pruned","retentionDays","BulkPruneBodySchema","BulkPruneResult","PruneStaleResult","publish","event","subscribe","BusSubscriber","sub","markFinished","SqliteEventBus","externallyModified","preview","ChangeRecord","login","token","GithubValidation","key","AnthropicValidation","ids","BulkUpdateBodySchema","BulkReopenBodySchema","ApplyPatchResult","updated","skipped","BulkArchiveResult","editor","command","OpenInEditorResult","dir","isDir","entries","FileEntry","query","ListFilesResult","stdout","cwd","HistoryStatusFilter","matchedFields","MatchedField","snippet","HistorySearchOpts","HistorySearchHit","branchName","description","prUrl","branchPushed","manualCompareUrl","files","ComposeOpts","ComposeResult","targetFile","prompt","isInitial","AgentPermissionMode","resume","abortSignal","AbortSignal","events","log","sessionId","isResult","resultFooter","run","AgentRunRequest","req","AsyncIterable","ProviderRunItem","AgentProvider","ProviderId","number","body","conversationIds","PullRequestRecord","minBackoffMs","maxBackoffMs","connect","WebSocket","attach","socket","schedule","fn","ms","msg","close","origin","attempt","min","max","RelayClientOptions","RelayClientHandle","ZodDefault","github","anthropic","SecretsFileSchema","connected","keySet","SecretsFile","Partial","setGithub","clearGithub","setAnthropic","clearAnthropic","getGithubToken","getAnthropicKey","presentable","PresentableConnections","text","PrSummary","added","deleted","WorkingCopyFileStatus","isDefaultBranch","WorkingCopyFile","ahead","behind","hasUpstream","dirty","pr","WorkingCopyPrRef","WorkingCopyStatus","WorktreeServerInfo","override","args","ServeResult","wss","WebSocketServer","httpServer","Server","ServerHandle"],"sources":["../../agent-runner/dist/index.d.ts","../src/server/metro-middleware.ts","../src/server/ws-endpoint.ts"],"mappings":";;;;;;;KA4CK,cAAA;;;;;;;;;;;;;;;;;;;;;;;iBAi2CY,wBAAA,IAA4B,eAAe;;;KCr2CvD,OAAA,IAAW,GAAA,EAAK,eAAA,EAAiB,GAAA,EAAK,cAAc,EAAE,IAAA;AAAA,UAE1C,sBAAA;;EAEf,WAAA;EDAG;;;;AAAc;ECMjB,SAAA,GAAY,cAAc;ED21Ca;;;AAAmB;;;;AC32C5B;;;;;;;;;;AAM2C;AAE3E;EA4BE,MAAA;AAAA;AAAA,UAGe,kBAAA;EAAA,CACd,GAAA,EAAK,eAAA,EAAiB,GAAA,EAAK,cAAA,EAAgB,IAAA;EAxB5C;EA0BA,KAAA,CAAM,IAAA,EAAM,OAAA,GAAU,OAAA;AAAA;AAAA,iBAGR,kBAAA,CAAmB,IAAA,EAAM,sBAAA,GAAyB,kBAAkB;;;UChCnE,uBAAA;ED6BH;;;;;;;;ECpBZ,WAAW;AAAA;;;;;ADoBkB;iBCZf,0BAAA,CACd,IAAA,EAAM,uBAAA,GACL,MAAA,SAAe,UAAA,QAAkB,wBAAA;;;;;;;;ADagD;;;;AChCpF;;;;AASa;AAQb;iBA+BgB,qBAAA,CAAsB,MAAc,EAAN,MAAM"}