@glubean/port 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,407 @@
+export type JsonValue = null | boolean | number | string | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type ProviderId = "codex" | "claude" | "gemini";
+export type SandboxMode = "read-only" | "workspace-write" | "danger-full-access";
+export type ApprovalPolicy = "untrusted" | "on-failure" | "on-request" | "never";
+export type ReasoningEffort = "low" | "medium" | "high" | "xhigh" | "max";
+export type ThinkingOptions = {
+    type: "adaptive";
+    display?: "summarized" | "omitted";
+} | {
+    type: "enabled";
+    budgetTokens?: number;
+    display?: "summarized" | "omitted";
+} | {
+    type: "disabled";
+};
+export type RuntimeInstructions = {
+    /**
+     * Provider-neutral instruction override when the provider exposes a system
+     * prompt style entrypoint.
+     */
+    system?: string;
+    /**
+     * Provider-neutral instruction appended to the provider's default behavior.
+     */
+    append?: string;
+};
+export type CommonRuntimeOptions = {
+    cwd?: string;
+    model?: string;
+    approvalPolicy?: ApprovalPolicy;
+    sandbox?: SandboxMode;
+    instructions?: RuntimeInstructions;
+};
+export type CodexReasoningEffort = "none" | "minimal" | ReasoningEffort;
+export type RuntimeEffort = CodexReasoningEffort;
+export type CodexRuntimeOptions = {
+    provider?: "codex";
+    modelProvider?: string;
+    serviceTier?: string;
+    effort?: CodexReasoningEffort;
+    reasoningSummary?: "auto" | "concise" | "detailed" | "none";
+    baseInstructions?: string;
+    developerInstructions?: string;
+    config?: Record<string, JsonValue>;
+};
+/**
+ * Codex spawn-only options that translate to top-level CLI args
+ * BEFORE the subcommand. Only honored at `createPort` time; cannot
+ * be set per-session or per-turn because they affect the spawned
+ * `codex app-server` process arguments. Pass them via
+ * `CreatePortInputFor<"codex">.spawnOptions`, NOT through
+ * RuntimeOptions on session.create / turn.start (those would be
+ * silently ignored — type system prevents that misuse here).
+ */
+export type CodexSpawnOptions = {
+    /**
+     * Codex feature flags to disable (top-level codex
+     * `--disable <FEATURE>` repeatable arg). Mirrors what
+     * `codex review` (codex-rs/core/src/tasks/review.rs) does for its
+     * sub-agent: disable tools that may trigger mid-turn round-trips
+     * which can interact poorly with structured-turn JSON-RPC stdio.
+     *
+     * Recommended set for reviewer-style structured turns
+     * (CLI keys verified against codex 0.128.0 — note the keys differ
+     * from Rust enum variant names):
+     *   ["multi_agent",     // = Feature::Collab
+     *    "enable_fanout",   // = Feature::SpawnCsv
+     *    "multi_agent_v2"]  // = Feature::MultiAgentV2
+     */
+    disableFeatures?: string[];
+    /**
+     * Codex web search mode override. Translated to `-c web_search_mode=<value>`.
+     * Codex review's sub-agent forces "disabled" (web_search_mode is a
+     * separate config field from feature flags).
+     */
+    webSearchMode?: "disabled" | "enabled" | "auto";
+};
+export type ClaudePermissionMode = "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan";
+export type ClaudeRuntimeOptions = {
+    provider?: "claude";
+    permissionMode?: ClaudePermissionMode;
+    effort?: RuntimeEffort;
+    thinking?: ThinkingOptions;
+    systemPrompt?: string;
+    appendSystemPrompt?: string;
+};
+export type GeminiApprovalMode = "default" | "auto_edit" | "yolo" | "plan";
+export type GeminiRuntimeOptions = {
+    provider?: "gemini";
+    approvalMode?: GeminiApprovalMode;
+    enableSandbox?: boolean;
+    settingsPath?: string;
+};
+export type ProviderRuntimeOptions = CodexRuntimeOptions | ClaudeRuntimeOptions | GeminiRuntimeOptions;
+export type ProviderRuntimeOptionsFor<P extends ProviderId> = P extends "codex" ? CodexRuntimeOptions : P extends "claude" ? ClaudeRuntimeOptions : P extends "gemini" ? GeminiRuntimeOptions : never;
+export type RuntimeOptions<P extends ProviderId = ProviderId> = P extends ProviderId ? CommonRuntimeOptions & ProviderRuntimeOptionsFor<P> : never;
+export type AgentInput = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    path: string;
+    detail?: "auto" | "low" | "high";
+};
+export type SchemaValidationResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: unknown;
+};
+export type ValidationSchema<T> = {
+    safeParse(value: unknown): SchemaValidationResult<T>;
+};
+export type CapabilitySet<P extends ProviderId = ProviderId> = {
+    provider: P;
+    nativeRpc: boolean;
+    transport: "stdio" | "websocket" | "unix";
+    sessions: {
+        create: boolean;
+        resume: boolean;
+        attach: boolean;
+        status: boolean;
+        list: boolean;
+        close: boolean;
+    };
+    turns: {
+        start: boolean;
+        submit: boolean;
+        status: boolean;
+        wait: boolean;
+        cancel: boolean;
+        steer: boolean;
+        outputSchema: boolean;
+    };
+    events: {
+        messageDelta: boolean;
+        reasoningDelta: boolean;
+        toolLifecycle: boolean;
+        tokenUsage: boolean;
+        planUpdates: boolean;
+        diffUpdates: boolean;
+    };
+    structuredOutput: {
+        jsonMode: boolean;
+        nativeJsonSchema: boolean;
+        localValidation: boolean;
+        retry: boolean;
+    };
+    lifecycle: {
+        localState: boolean;
+        eventReplay: "none" | "memory" | "durable";
+        status: "none" | "local" | "native";
+    };
+};
+export type SessionLifecycleStatus = "idle" | "running" | "closed" | "unknown";
+export type TurnLifecycleStatus = "running" | "completed" | "failed" | "cancelled" | "timeout" | "unknown";
+export type SessionRef<P extends ProviderId = ProviderId> = {
+    id: string;
+    provider: P;
+    native?: Record<string, JsonValue>;
+};
+export type SessionStatusInput = {
+    id: string;
+};
+export type SessionListInput = {
+    status?: SessionLifecycleStatus;
+};
+export type CloseSessionInput = {
+    id: string;
+    cancelActiveTurns?: boolean;
+};
+export type SessionSnapshot<P extends ProviderId = ProviderId> = SessionRef<P> & {
+    status: SessionLifecycleStatus;
+    createdAt?: string;
+    updatedAt?: string;
+    activeTurnIds: string[];
+};
+export type CreateSessionInput<P extends ProviderId = ProviderId> = {
+    id?: string;
+    options?: RuntimeOptions<P>;
+    cwd?: string;
+    model?: string;
+    approvalPolicy?: ApprovalPolicy;
+    sandbox?: SandboxMode;
+};
+export type StartTurnInput<P extends ProviderId = ProviderId> = {
+    sessionId: string;
+    input: AgentInput[];
+    options?: RuntimeOptions<P>;
+    cwd?: string;
+    model?: string;
+    approvalPolicy?: ApprovalPolicy;
+    sandbox?: SandboxMode;
+    outputSchema?: JsonValue;
+    timeoutMs?: number;
+};
+export type SubmitTurnInput<P extends ProviderId = ProviderId> = StartTurnInput<P> & {
+    /**
+     * How long submit waits for the provider to accept the turn and expose a
+     * turn id. This is not the model-response timeout; use timeoutMs for that.
+     */
+    acceptTimeoutMs?: number;
+};
+export type StartStructuredTurnInput<T = JsonValue, P extends ProviderId = ProviderId> = Omit<StartTurnInput<P>, "outputSchema"> & {
+    jsonMode?: boolean;
+    outputSchema?: JsonValue;
+    schema?: ValidationSchema<T>;
+    maxRetries?: number;
+};
+export type CancelTurnInput = {
+    sessionId: string;
+    turnId: string;
+};
+export type TurnRef<P extends ProviderId = ProviderId> = {
+    provider: P;
+    sessionId: string;
+    turnId: string;
+};
+export type TurnStatusInput = {
+    sessionId: string;
+    turnId: string;
+};
+export type TurnWaitInput = TurnStatusInput & {
+    timeoutMs?: number;
+};
+export type EventSubscriptionInput = {
+    sessionId?: string;
+    turnId?: string;
+    afterSeq?: number;
+    replay?: boolean;
+};
+export type TurnStreamInput = EventSubscriptionInput & {
+    sessionId: string;
+    turnId: string;
+};
+export type ToolCall = {
+    id: string;
+    name: string;
+    input?: JsonValue;
+};
+export type TokenUsage = {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    cachedInputTokens?: number;
+    cacheCreationInputTokens?: number;
+    cacheReadInputTokens?: number;
+    reasoningOutputTokens?: number;
+};
+export type PlanStep = {
+    step: string;
+    status: "pending" | "in_progress" | "completed";
+};
+export type AgentEvent = {
+    type: "session.started";
+    sessionId: string;
+    provider: ProviderId;
+    native?: Record<string, JsonValue>;
+} | {
+    type: "turn.started";
+    sessionId: string;
+    turnId: string;
+} | {
+    type: "message.delta";
+    sessionId?: string;
+    turnId?: string;
+    role: "assistant";
+    text: string;
+} | {
+    type: "reasoning.delta";
+    sessionId?: string;
+    turnId?: string;
+    text: string;
+} | {
+    type: "plan.updated";
+    sessionId: string;
+    turnId: string;
+    explanation?: string;
+    steps: PlanStep[];
+} | {
+    type: "tool.started";
+    sessionId?: string;
+    turnId?: string;
+    toolCall: ToolCall;
+} | {
+    type: "tool.completed";
+    sessionId?: string;
+    turnId?: string;
+    toolCallId: string;
+    name?: string;
+    result?: JsonValue;
+} | {
+    type: "token.usage";
+    sessionId?: string;
+    turnId?: string;
+    usage: TokenUsage;
+    totalUsage?: TokenUsage;
+    contextWindow?: number | null;
+    native?: JsonValue;
+} | {
+    type: "diff.updated";
+    sessionId: string;
+    turnId: string;
+    diff: string;
+} | {
+    type: "error";
+    sessionId?: string;
+    turnId?: string;
+    message: string;
+    native?: JsonValue;
+} | {
+    type: "turn.completed";
+    sessionId: string;
+    turnId: string;
+    status: "completed" | "failed" | "cancelled" | "timeout";
+    error?: string;
+};
+export type RecordedAgentEvent = AgentEvent & {
+    seq: number;
+    recordedAt: string;
+};
+export type TurnSnapshot<P extends ProviderId = ProviderId> = TurnRef<P> & {
+    status: TurnLifecycleStatus;
+    cwd?: string;
+    model?: string;
+    options?: RuntimeOptions<P>;
+    usage?: TokenUsage;
+    totalUsage?: TokenUsage;
+    contextWindow?: number | null;
+    startedAt?: string;
+    updatedAt?: string;
+    completedAt?: string;
+    error?: string;
+    eventCount: number;
+};
+export type TurnResult<P extends ProviderId = ProviderId> = TurnSnapshot<P> & {
+    text: string;
+    events: RecordedAgentEvent[];
+};
+export type StructuredTurnAttempt = {
+    index: number;
+    events: AgentEvent[];
+    text: string;
+    error?: string;
+};
+export type StructuredTurnResult<T = JsonValue> = {
+    data: T;
+    json: JsonValue;
+    text: string;
+    attempts: StructuredTurnAttempt[];
+};
+export interface Port<P extends ProviderId = ProviderId> {
+    provider: P;
+    capabilities: CapabilitySet<P>;
+    sessions: {
+        create(input?: CreateSessionInput<P>): Promise<SessionRef<P>>;
+        resume(input: CreateSessionInput<P> & {
+            id: string;
+        }): Promise<SessionRef<P>>;
+        attach(input: CreateSessionInput<P> & {
+            id: string;
+        }): Promise<SessionRef<P>>;
+        status(input: SessionStatusInput): Promise<SessionSnapshot<P>>;
+        list(input?: SessionListInput): Promise<SessionSnapshot<P>[]>;
+        close(input: CloseSessionInput): Promise<void>;
+    };
+    turns: {
+        start(input: StartTurnInput<P>): AsyncIterable<AgentEvent>;
+        submit(input: SubmitTurnInput<P>): Promise<TurnRef<P>>;
+        status(input: TurnStatusInput): Promise<TurnSnapshot<P>>;
+        stream(input: TurnStreamInput): AsyncIterable<RecordedAgentEvent>;
+        wait(input: TurnWaitInput): Promise<TurnResult<P>>;
+        startStructured<T = JsonValue>(input: StartStructuredTurnInput<T, P>): Promise<StructuredTurnResult<T>>;
+        cancel(input: CancelTurnInput): Promise<void>;
+    };
+    events(input?: EventSubscriptionInput): AsyncIterable<RecordedAgentEvent>;
+    close(): Promise<void>;
+}
+/**
+ * Provider-specific spawn-only options. Only honored at `createPort`
+ * time and applied to the spawned process arguments. Per-session /
+ * per-turn options have no effect on these — they are physically
+ * baked into the subprocess CLI args.
+ */
+export type SpawnOptionsFor<P extends ProviderId> = P extends "codex" ? CodexSpawnOptions : never;
+export type CreatePortInputFor<P extends ProviderId> = {
+    provider: P;
+    options?: RuntimeOptions<P>;
+    /**
+     * Provider-specific spawn-only options (e.g. codex
+     * `disableFeatures` / `webSearchMode`). Only honored here, NOT on
+     * session/turn options. Currently codex-only; other providers
+     * resolve to `never`.
+     */
+    spawnOptions?: SpawnOptionsFor<P>;
+    cwd?: string;
+    command?: string;
+    args?: string[];
+    env?: NodeJS.ProcessEnv;
+};
+export type CreatePortInput = {
+    [P in ProviderId]: CreatePortInputFor<P>;
+}[ProviderId];
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@glubean/port",
+  "version": "0.1.0",
+  "description": "Neutral runtime adapter for local coding agents.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run --exclude \"src/**/*.integration.test.ts\"",
+    "typecheck": "tsc --noEmit",
+    "test:integration": "GLUBEAN_PORT_LIVE=1 vitest run src/providers/live.integration.test.ts",
+    "smoke:codex": "node examples/codex-basic.ts",
+    "prepack": "npm run build"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
+  }
+}