humanish 0.0.1 → 0.15.0

package/dist/pi-agent-core.d.ts

@@ -0,0 +1,77 @@
+import { type ActorCompletionReason, type ActorPersonaRef, type ActorStatus, type ActorTrace } from "./actor-contract.js";
+export type PiStopReason = "stop" | "toolUse" | "length" | "error" | "aborted";
+export type PiAgentEvent = {
+    type: "agent_start";
+} | {
+    type: "agent_end";
+} | {
+    type: "turn_start";
+} | {
+    type: "turn_end";
+} | {
+    type: "message_start";
+    role?: string;
+} | {
+    type: "message_update";
+    textDelta?: string;
+    thinkingDelta?: string;
+} | {
+    type: "message_end";
+    text?: string;
+    thinking?: string;
+} | {
+    type: "tool_execution_start";
+    toolCallId: string;
+    toolName: string;
+} | {
+    type: "tool_execution_end";
+    toolCallId: string;
+    toolName?: string;
+    isError?: boolean;
+} | {
+    type: "queue_update";
+    summary?: string;
+} | {
+    type: "compaction_start";
+} | {
+    type: "compaction_end";
+} | {
+    type: "auto_retry_start";
+} | {
+    type: "auto_retry_end";
+} | {
+    type: "notice";
+    method?: string;
+    message?: string;
+};
+export interface PiSessionStats {
+    tokens?: {
+        input?: number;
+        output?: number;
+        total?: number;
+        cacheRead?: number;
+        cacheWrite?: number;
+    };
+    cost?: number;
+}
+export interface PiSessionResult {
+    events: PiAgentEvent[];
+    sessionId?: string;
+    model?: string;
+    providerVersion?: string;
+    startedAt: string;
+    completedAt: string;
+    durationMs: number;
+    status: ActorStatus;
+    reason: string;
+    stats?: PiSessionStats;
+}
+export declare function piStopReasonToStatus(stop: PiStopReason): ActorStatus;
+export declare function piStatusToCompletionReason(status: ActorStatus): ActorCompletionReason;
+/**
+ * Map a pi-agent-core session into the provider-neutral ActorTrace. Pure and
+ * side-effect-free; mirrors codexResultToActorTrace. The persona reference is
+ * supplied by the harness. Used by the actorRegistry to prove the contract is
+ * provider-neutral ahead of the live SDK shim.
+ */
+export declare function piSessionToActorTrace(session: PiSessionResult, persona: ActorPersonaRef): ActorTrace;

package/dist/pi-agent-core.js

@@ -0,0 +1,203 @@
+import { ACTOR_TRACE_SCHEMA, PI_AGENT_CORE_CAPABILITIES } from "./actor-contract.js";
+import { redactText } from "./redaction.js";
+export function piStopReasonToStatus(stop) {
+    switch (stop) {
+        case "stop":
+        case "toolUse":
+            return "passed";
+        case "length":
+            return "timed_out";
+        case "aborted":
+            return "blocked";
+        case "error":
+            return "failed";
+    }
+}
+export function piStatusToCompletionReason(status) {
+    switch (status) {
+        case "passed":
+            return "turn_completed";
+        case "timed_out":
+            return "timed_out";
+        case "blocked":
+            return "blocked_approval";
+        case "failed":
+            return "actor_error";
+    }
+}
+function pickPiTokenUsage(stats) {
+    if (!stats) {
+        return undefined;
+    }
+    const num = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
+    const input = num(stats.tokens?.input);
+    const output = num(stats.tokens?.output);
+    const total = num(stats.tokens?.total);
+    const costUsd = num(stats.cost);
+    const usage = {
+        ...(input === undefined ? {} : { input }),
+        ...(output === undefined ? {} : { output }),
+        ...(total === undefined ? {} : { total }),
+        ...(costUsd === undefined ? {} : { costUsd })
+    };
+    return Object.keys(usage).length > 0 ? usage : undefined;
+}
+// Project the pi event stream into provider-neutral ActorTraceItems. pi has no
+// native file_change / screenshot / ui_action / approval events today, so none
+// are fabricated (intentional, not incomplete). Bash runs surface as tool_call,
+// not command, until the live shim can inspect tool results.
+function piEventsToActorItems(events) {
+    const items = [];
+    const toolNames = new Map();
+    let messageOrdinal = 0;
+    let noticeOrdinal = 0;
+    let textBuffer = "";
+    let thinkingBuffer = "";
+    const flushMessage = (endText, endThinking) => {
+        const text = (endText ?? textBuffer).trim();
+        const thinking = (endThinking ?? thinkingBuffer).trim();
+        messageOrdinal += 1;
+        if (thinking.length > 0) {
+            items.push({
+                id: `reasoning-${messageOrdinal}`,
+                kind: "reasoning",
+                lifecycle: "completed",
+                title: "Reasoning",
+                text: redactText(thinking)
+            });
+        }
+        items.push({
+            id: `message-${messageOrdinal}`,
+            kind: "message",
+            lifecycle: "completed",
+            title: "Assistant message",
+            ...(text.length > 0 ? { text: redactText(text) } : {})
+        });
+        textBuffer = "";
+        thinkingBuffer = "";
+    };
+    for (const event of events) {
+        switch (event.type) {
+            case "message_start":
+                items.push({ id: `message-start-${messageOrdinal + 1}`, kind: "message", lifecycle: "started", title: "Assistant message" });
+                break;
+            case "message_update":
+                if (event.textDelta) {
+                    textBuffer += event.textDelta;
+                }
+                if (event.thinkingDelta) {
+                    thinkingBuffer += event.thinkingDelta;
+                }
+                break;
+            case "message_end":
+                flushMessage(event.text, event.thinking);
+                break;
+            case "tool_execution_start": {
+                toolNames.set(event.toolCallId, event.toolName);
+                const name = redactText(event.toolName);
+                items.push({
+                    id: event.toolCallId,
+                    kind: "tool_call",
+                    lifecycle: "started",
+                    title: name,
+                    tool: { name }
+                });
+                break;
+            }
+            case "tool_execution_end": {
+                const name = redactText(event.toolName ?? toolNames.get(event.toolCallId) ?? "tool");
+                items.push({
+                    id: `${event.toolCallId}-end`,
+                    kind: "tool_call",
+                    lifecycle: "completed",
+                    ...(event.isError ? { status: "error" } : {}),
+                    title: name,
+                    tool: { name }
+                });
+                break;
+            }
+            case "queue_update":
+                noticeOrdinal += 1;
+                items.push({
+                    id: `plan-${noticeOrdinal}`,
+                    kind: "plan",
+                    lifecycle: "completed",
+                    title: "Queue update",
+                    ...(event.summary ? { text: redactText(event.summary) } : {})
+                });
+                break;
+            case "compaction_start":
+            case "compaction_end":
+            case "auto_retry_start":
+            case "auto_retry_end":
+                noticeOrdinal += 1;
+                items.push({
+                    id: `notice-${noticeOrdinal}`,
+                    kind: "notice",
+                    lifecycle: event.type.endsWith("_start") ? "started" : "completed",
+                    title: event.type
+                });
+                break;
+            case "notice":
+                noticeOrdinal += 1;
+                items.push({
+                    id: `notice-${noticeOrdinal}`,
+                    kind: "notice",
+                    lifecycle: "completed",
+                    title: event.method ?? "notice",
+                    ...(event.message ? { text: redactText(event.message) } : {})
+                });
+                break;
+            default:
+                // agent_start / agent_end / turn_start / turn_end carry no item evidence.
+                break;
+        }
+    }
+    // Terminal flush: if the stream ended mid-message (abnormal termination such as
+    // an error/abort/length cutoff), preserve the partial assistant text/reasoning.
+    if (textBuffer.length > 0 || thinkingBuffer.length > 0) {
+        flushMessage(undefined, undefined);
+    }
+    return items;
+}
+/**
+ * Map a pi-agent-core session into the provider-neutral ActorTrace. Pure and
+ * side-effect-free; mirrors codexResultToActorTrace. The persona reference is
+ * supplied by the harness. Used by the actorRegistry to prove the contract is
+ * provider-neutral ahead of the live SDK shim.
+ */
+export function piSessionToActorTrace(session, persona) {
+    const tokenUsage = pickPiTokenUsage(session.stats);
+    const items = piEventsToActorItems(session.events);
+    return {
+        schema: ACTOR_TRACE_SCHEMA,
+        provider: "pi-agent-core",
+        ...(session.providerVersion === undefined ? {} : { providerVersion: session.providerVersion }),
+        protocol: "in-process-sdk",
+        lane: "code",
+        persona,
+        redaction: {
+            status: "passed",
+            screenshots: "n/a",
+            notes: "pi event stream projected to actor trace; secret-like text is rejected by verify."
+        },
+        startedAt: session.startedAt,
+        completedAt: session.completedAt,
+        durationMs: session.durationMs,
+        status: session.status,
+        completionReason: piStatusToCompletionReason(session.status),
+        reason: redactText(session.reason),
+        ids: {
+            ...(session.sessionId === undefined ? {} : { sessionId: session.sessionId }),
+            ...(session.model === undefined ? {} : { model: session.model })
+        },
+        counts: {
+            events: session.events.length,
+            items: items.length
+        },
+        items,
+        ...(tokenUsage === undefined ? {} : { tokenUsage }),
+        capabilities: PI_AGENT_CORE_CAPABILITIES
+    };
+}
+//# sourceMappingURL=pi-agent-core.js.map

package/dist/pi-agent-core.js.map

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

package/dist/program.d.ts

@@ -0,0 +1,54 @@
+import { Command } from "commander";
+import type { ObserverResult, ObserverServer } from "./observer.js";
+import type { OssMetaLabResult } from "./oss-meta-lab.js";
+export declare const CLI_RESPONSE_SCHEMA = "humanish.cli-response.v1";
+export interface CliIo {
+    writeOut(text: string): void;
+    writeErr(text: string): void;
+    setExitCode(code: number): void;
+}
+export interface UnexpectedErrorEnvelope {
+    schema: typeof CLI_RESPONSE_SCHEMA;
+    ok: false;
+    error: {
+        code: "HUMANISH_UNEXPECTED";
+        message: string;
+    };
+}
+export declare function createProgram(io?: Partial<CliIo>): Command;
+/**
+ * Default browser-open policy for a lab backend run. Mirrors the observe/watch gate:
+ * an explicit --open/--no-open wins; --json (machine mode) never auto-opens; otherwise a
+ * lab-config `defaults.open` wins, and the final fallback opens only for an interactive
+ * `watch` on a real TTY. Extracted so all lab backends share one gate (and one test).
+ */
+export declare function resolveBackendShouldOpen(args: {
+    optionOpen: boolean | undefined;
+    defaultsOpen: boolean | undefined;
+    mode: string;
+    wantsMachine: boolean;
+}): boolean;
+export declare function writeResult<T>(command: Command, io: CliIo, result: T, formatHuman: (result: T) => string): void;
+type WatchStopSignal = "SIGINT" | "SIGTERM" | "SIGHUP";
+interface WatchSignalTarget {
+    once(event: WatchStopSignal, listener: () => void): unknown;
+    removeListener(event: WatchStopSignal, listener: () => void): unknown;
+}
+export declare function followObserver(io: CliIo, result: ObserverResult, server: ObserverServer, options?: {
+    onStop?: () => Promise<string[]>;
+    signalTarget?: WatchSignalTarget;
+    signals?: WatchStopSignal[];
+}): Promise<void>;
+export declare function shouldForceExitAfterOssMetaLab(output: OssMetaLabResult, options: {
+    detach: boolean;
+    wantsMachine: boolean;
+}): boolean;
+export declare function shouldServeOssMetaLabObserver(output: OssMetaLabResult, options: {
+    wantsFollow: boolean;
+}): output is OssMetaLabResult & {
+    observer: ObserverResult & {
+        ok: true;
+    };
+};
+export declare function exitCodeForOssMetaLab(output: OssMetaLabResult): number;
+export {};