@emiliosp/pi-maestro 0.0.0-stage → 0.1.0

package/node_modules/pi-subagents/src/api/external-job-provider.js

@@ -0,0 +1,140 @@
+export const EXTERNAL_JOB_PROVIDER_PROTOCOL_VERSION = 1;
+export const EXTERNAL_JOB_PROVIDER_REGISTRY_KEY = "pi-subagents.external-job-providers.v1";
+const MAX_PROVIDER_NAME_LENGTH = 128;
+const MAX_PROVIDERS = 100;
+const MAX_JOB_ID_LENGTH = 256;
+const MAX_FAILURE_CODE_LENGTH = 128;
+const MAX_FAILURE_MESSAGE_LENGTH = 4_096;
+const MAX_URL_LENGTH = 4_096;
+export class ExternalJobProviderError extends Error {
+    code;
+    blockingJobId;
+    constructor(message, options) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = "ExternalJobProviderError";
+        this.code = options.code;
+        this.blockingJobId = options.blockingJobId;
+    }
+}
+function registry() {
+    const key = Symbol.for(EXTERNAL_JOB_PROVIDER_REGISTRY_KEY);
+    const globalObject = globalThis;
+    const existing = globalObject[key];
+    if (existing === undefined) {
+        const created = {
+            version: EXTERNAL_JOB_PROVIDER_PROTOCOL_VERSION,
+            providers: new Map(),
+        };
+        globalObject[key] = created;
+        return created;
+    }
+    if (!existing || typeof existing !== "object" || Array.isArray(existing)) {
+        throw new Error(`Malformed external-job provider registry at Symbol.for("${EXTERNAL_JOB_PROVIDER_REGISTRY_KEY}").`);
+    }
+    const candidate = existing;
+    if (candidate.version !== EXTERNAL_JOB_PROVIDER_PROTOCOL_VERSION || !(candidate.providers instanceof Map)) {
+        throw new Error(`Unsupported external-job provider registry at Symbol.for("${EXTERNAL_JOB_PROVIDER_REGISTRY_KEY}").`);
+    }
+    return candidate;
+}
+function validateString(value, field, maxLength) {
+    if (typeof value !== "string" || value.length === 0 || value.trim() !== value) {
+        throw new Error(`${field} must be a non-empty string without leading or trailing whitespace.`);
+    }
+    if (value.length > maxLength)
+        throw new Error(`${field} must be at most ${maxLength} characters.`);
+    if (value.includes("\0"))
+        throw new Error(`${field} must not contain NUL characters.`);
+    return value;
+}
+function validateOptionalString(value, field, maxLength) {
+    if (value === undefined)
+        return undefined;
+    return validateString(value, field, maxLength);
+}
+function validateState(value, field) {
+    if (value === "queued" || value === "running" || value === "completed" || value === "failed" || value === "stopped" || value === "blocked")
+        return value;
+    throw new Error(`${field} must be queued, running, completed, failed, stopped, or blocked.`);
+}
+function validateHandle(provider, value, field, extraFields = []) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error(`${field} from external-job provider '${provider}' must be an object.`);
+    const handle = value;
+    const supported = new Set(["providerJobId", "state", "handleUrl", "conversationUrl", "failureCode", "failureMessage", "blockingJobId", ...extraFields]);
+    const unknown = Object.keys(handle).filter((key) => !supported.has(key));
+    if (unknown.length > 0)
+        throw new Error(`${field} from external-job provider '${provider}' has unknown fields: ${unknown.join(", ")}.`);
+    const handleUrl = validateOptionalString(handle.handleUrl, `${field}.handleUrl`, MAX_URL_LENGTH);
+    const conversationUrl = validateOptionalString(handle.conversationUrl, `${field}.conversationUrl`, MAX_URL_LENGTH);
+    const failureCode = validateOptionalString(handle.failureCode, `${field}.failureCode`, MAX_FAILURE_CODE_LENGTH);
+    const failureMessage = validateOptionalString(handle.failureMessage, `${field}.failureMessage`, MAX_FAILURE_MESSAGE_LENGTH);
+    const blockingJobId = validateOptionalString(handle.blockingJobId, `${field}.blockingJobId`, MAX_JOB_ID_LENGTH);
+    return {
+        providerJobId: validateString(handle.providerJobId, `${field}.providerJobId`, MAX_JOB_ID_LENGTH),
+        state: validateState(handle.state, `${field}.state`),
+        ...(handleUrl ? { handleUrl } : {}),
+        ...(conversationUrl ? { conversationUrl } : {}),
+        ...(failureCode ? { failureCode } : {}),
+        ...(failureMessage ? { failureMessage } : {}),
+        ...(blockingJobId ? { blockingJobId } : {}),
+    };
+}
+export function validateExternalJobHandle(provider, value, field = "External-job handle") {
+    return validateHandle(provider, value, field);
+}
+export function validateExternalJobResult(provider, value, field = "External-job result") {
+    const result = validateHandle(provider, value, field, ["output", "artifactPath"]);
+    const record = value;
+    const output = validateOptionalString(record.output, `${field}.output`, 1024 * 1024);
+    const artifactPath = validateOptionalString(record.artifactPath, `${field}.artifactPath`, MAX_URL_LENGTH);
+    return {
+        ...result,
+        ...(output !== undefined ? { output } : {}),
+        ...(artifactPath !== undefined ? { artifactPath } : {}),
+    };
+}
+function validateProvider(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("External-job provider must be an object.");
+    const provider = value;
+    // Tolerate extra provider fields (for example kind, wakeChannels, or future
+    // operations) so one evolving provider cannot poison registry reads for all
+    // providers. Payload validation stays strict.
+    const name = validateString(provider.name, "External-job provider name", MAX_PROVIDER_NAME_LENGTH);
+    for (const op of ["start", "status", "result", "reattach"]) {
+        if (typeof provider[op] !== "function")
+            throw new Error(`External-job provider '${name}' must expose ${op}().`);
+    }
+    return value;
+}
+export function registerExternalJobProvider(provider) {
+    const validated = validateProvider(provider);
+    const current = registry();
+    if (!current.providers.has(validated.name) && current.providers.size >= MAX_PROVIDERS) {
+        throw new Error(`External-job provider registry supports at most ${MAX_PROVIDERS} providers.`);
+    }
+    current.providers.set(validated.name, validated);
+    return () => {
+        if (current.providers.get(validated.name) === validated)
+            current.providers.delete(validated.name);
+    };
+}
+export function listExternalJobProviders() {
+    const current = registry();
+    if (current.providers.size > MAX_PROVIDERS)
+        throw new Error(`External-job provider registry contains more than ${MAX_PROVIDERS} providers.`);
+    const providers = [];
+    for (const [key, value] of current.providers) {
+        const provider = validateProvider(value);
+        if (key !== provider.name)
+            throw new Error(`External-job provider registry key '${key}' does not match provider name '${provider.name}'.`);
+        providers.push(provider);
+    }
+    return providers;
+}
+export function getExternalJobProvider(name) {
+    const safeName = validateString(name, "External-job provider name", MAX_PROVIDER_NAME_LENGTH);
+    return listExternalJobProviders().find((provider) => provider.name === safeName);
+}
+//# sourceMappingURL=external-job-provider.js.map

package/node_modules/pi-subagents/src/api/external-job-provider.js.map

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

package/node_modules/pi-subagents/src/api/external-runs.d.ts

@@ -0,0 +1,48 @@
+export declare const EXTERNAL_RUN_REGISTRY_VERSION = 2;
+export declare const EXTERNAL_RUN_REGISTRY_KEY = "pi-subagents.external-runs.v2";
+export declare const EXTERNAL_RUN_LIMITS: {
+    readonly maxCachedRuns: 100;
+    readonly maxSnapshotRuns: 20;
+    readonly maxIdentityLength: 160;
+    /**
+     * A Pi session id is the session file path, which routinely exceeds a short
+     * identity budget in nested worktrees, so it is bounded like the other paths.
+     */
+    readonly maxSessionIdLength: 4096;
+    readonly maxTextLength: 160;
+    readonly maxPreviewLength: 4096;
+    readonly maxPathLength: 4096;
+    readonly maxSerializedBytes: number;
+};
+export type ExternalRunState = "queued" | "running" | "completed" | "failed" | "stopped";
+/** A display-only record for work owned by another extension or runtime. */
+export interface ExternalRun {
+    id: string;
+    sessionId: string;
+    source: string;
+    label: string;
+    state: ExternalRunState;
+    startedAt: number;
+    updatedAt?: number;
+    endedAt?: number;
+    currentAction?: string;
+    preview?: string;
+    reportPath?: string;
+    transcriptPath?: string;
+}
+export type ExternalRunUpdate = Partial<Omit<ExternalRun, "id" | "sessionId" | "source">>;
+export interface ExternalRunSnapshotOptions {
+    onMalformedRecord?: (message: string) => void;
+    ignoreMalformed?: boolean;
+}
+/** Register one current-session external job. pi-subagents never controls the job. */
+export declare function registerExternalRun(input: ExternalRun): ExternalRun;
+/** Update display fields for a registered external job without changing its identity or owner. */
+export declare function updateExternalRun(sessionId: string, id: string, update: ExternalRunUpdate): ExternalRun;
+/** Remove a cached external job. The caller remains responsible for its process and artifacts. */
+export declare function unregisterExternalRun(sessionId: string, id: string): boolean;
+/** Read a bounded cached snapshot for one Pi session. This never invokes third-party code. */
+export declare function snapshotExternalRuns(sessionId: string, options?: ExternalRunSnapshotOptions): readonly ExternalRun[];
+/** Alias for callers that prefer list terminology. */
+export declare const listExternalRuns: typeof snapshotExternalRuns;
+//# sourceMappingURL=external-runs.d.ts.map

package/node_modules/pi-subagents/src/api/external-runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-runs.d.ts","sourceRoot":"","sources":["../../../src/api/external-runs.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,eAAO,MAAM,yBAAyB,kCAAkC,CAAC;AAEzE,eAAO,MAAM,mBAAmB;;;;IAI/B;;;OAGG;;;;;;CAMM,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzF,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,gBAAgB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC;AAE1F,MAAM,WAAW,0BAA0B;IAC1C,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B;AAkKD,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CASnE;AAED,kGAAkG;AAClG,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAYvG;AAED,kGAAkG;AAClG,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAM5E;AAUD,8FAA8F;AAC9F,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,0BAA+B,GAAG,SAAS,WAAW,EAAE,CA4BxH;AAED,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,6BAAuB,CAAC"}

package/node_modules/pi-subagents/src/api/external-runs.js

@@ -0,0 +1,245 @@
+import { sanitizeDisplayText, truncateDisplayText } from "../shared/display-text.js";
+export const EXTERNAL_RUN_REGISTRY_VERSION = 2;
+export const EXTERNAL_RUN_REGISTRY_KEY = "pi-subagents.external-runs.v2";
+export const EXTERNAL_RUN_LIMITS = {
+    maxCachedRuns: 100,
+    maxSnapshotRuns: 20,
+    maxIdentityLength: 160,
+    /**
+     * A Pi session id is the session file path, which routinely exceeds a short
+     * identity budget in nested worktrees, so it is bounded like the other paths.
+     */
+    maxSessionIdLength: 4_096,
+    maxTextLength: 160,
+    maxPreviewLength: 4_096,
+    maxPathLength: 4_096,
+    maxSerializedBytes: 32 * 1_024,
+};
+const trustedRecordsByRegistry = new WeakMap();
+const RUN_FIELD_NAMES = [
+    "id",
+    "sessionId",
+    "source",
+    "label",
+    "state",
+    "startedAt",
+    "updatedAt",
+    "endedAt",
+    "currentAction",
+    "preview",
+    "reportPath",
+    "transcriptPath",
+];
+const RUN_FIELDS = new Set(RUN_FIELD_NAMES);
+const UPDATE_FIELDS = new Set([...RUN_FIELDS].filter((field) => field !== "id" && field !== "sessionId" && field !== "source"));
+function registry() {
+    const key = Symbol.for(EXTERNAL_RUN_REGISTRY_KEY);
+    const target = globalThis;
+    const existing = target[key];
+    if (existing === undefined) {
+        const created = { version: EXTERNAL_RUN_REGISTRY_VERSION, runs: new Map() };
+        target[key] = created;
+        return created;
+    }
+    if (!existing || typeof existing !== "object" || Array.isArray(existing))
+        throw new Error(`Malformed external-run registry at Symbol.for("${EXTERNAL_RUN_REGISTRY_KEY}").`);
+    const candidate = existing;
+    if (candidate.version !== EXTERNAL_RUN_REGISTRY_VERSION || !(candidate.runs instanceof Map))
+        throw new Error(`Unsupported external-run registry at Symbol.for("${EXTERNAL_RUN_REGISTRY_KEY}").`);
+    return candidate;
+}
+function trustedRecords(current) {
+    const cached = trustedRecordsByRegistry.get(current);
+    if (cached)
+        return cached;
+    const records = new Map();
+    trustedRecordsByRegistry.set(current, records);
+    return records;
+}
+function inputObject(value, field, allowed) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error(`${field} must be an object.`);
+    const input = value;
+    const unknown = Object.keys(input).filter((key) => !allowed.has(key));
+    if (unknown.length)
+        throw new Error(`${field} has unknown fields: ${unknown.join(", ")}.`);
+    return input;
+}
+function identity(value, field, maxLength = EXTERNAL_RUN_LIMITS.maxIdentityLength) {
+    if (typeof value !== "string" || value.length === 0 || value.trim() !== value || value.includes("\0"))
+        throw new Error(`${field} must be a non-empty trimmed string without NUL characters.`);
+    if (value.length > maxLength)
+        throw new Error(`${field} must be at most ${maxLength} characters.`);
+    const safe = sanitizeDisplayText(value);
+    if (!safe || safe !== value)
+        throw new Error(`${field} must contain only display-safe text.`);
+    return value;
+}
+function displayText(value, field, maxLength, required = false) {
+    if (value === undefined && !required)
+        return undefined;
+    if (typeof value !== "string" || value.length === 0)
+        throw new Error(`${field} must be a non-empty string.`);
+    const safe = sanitizeDisplayText(value.slice(0, Math.max(maxLength * 4, maxLength)));
+    if (!safe)
+        throw new Error(`${field} must contain displayable text.`);
+    return truncateDisplayText(safe, maxLength);
+}
+function timestamp(value, field, required = false) {
+    if (value === undefined && !required)
+        return undefined;
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0 || value > 8_640_000_000_000_000)
+        throw new Error(`${field} must be a non-negative safe timestamp.`);
+    return value;
+}
+function state(value, field) {
+    if (value === "queued" || value === "running" || value === "completed" || value === "failed" || value === "stopped")
+        return value;
+    throw new Error(`${field} is invalid.`);
+}
+function validateRun(value) {
+    const run = inputObject(value, "External run", RUN_FIELDS);
+    const updatedAt = timestamp(run.updatedAt, "External run updatedAt");
+    const endedAt = timestamp(run.endedAt, "External run endedAt");
+    const currentAction = displayText(run.currentAction, "External run currentAction", EXTERNAL_RUN_LIMITS.maxTextLength);
+    const preview = displayText(run.preview, "External run preview", EXTERNAL_RUN_LIMITS.maxPreviewLength);
+    const reportPath = displayText(run.reportPath, "External run reportPath", EXTERNAL_RUN_LIMITS.maxPathLength);
+    const transcriptPath = displayText(run.transcriptPath, "External run transcriptPath", EXTERNAL_RUN_LIMITS.maxPathLength);
+    return {
+        id: identity(run.id, "External run id"),
+        sessionId: identity(run.sessionId, "External run sessionId", EXTERNAL_RUN_LIMITS.maxSessionIdLength),
+        source: displayText(run.source, "External run source", EXTERNAL_RUN_LIMITS.maxTextLength, true),
+        label: displayText(run.label, "External run label", EXTERNAL_RUN_LIMITS.maxTextLength, true),
+        state: state(run.state, "External run state"),
+        startedAt: timestamp(run.startedAt, "External run startedAt", true),
+        ...(updatedAt !== undefined ? { updatedAt } : {}),
+        ...(endedAt !== undefined ? { endedAt } : {}),
+        ...(currentAction ? { currentAction } : {}),
+        ...(preview ? { preview } : {}),
+        ...(reportPath ? { reportPath } : {}),
+        ...(transcriptPath ? { transcriptPath } : {}),
+    };
+}
+function key(sessionId, id) {
+    return `${sessionId}\0${id}`;
+}
+function clone(run) {
+    return { ...run };
+}
+function trustedRecord(value, normalized) {
+    const candidate = value;
+    return {
+        value,
+        normalized,
+        keys: Object.keys(candidate),
+        values: RUN_FIELD_NAMES.map((field) => candidate[field]),
+    };
+}
+function trustedRecordValue(value, record) {
+    if (!record || record.value !== value || !value || typeof value !== "object")
+        return undefined;
+    try {
+        const candidate = value;
+        const keys = Object.keys(candidate);
+        if (keys.length !== record.keys.length || keys.some((key, index) => key !== record.keys[index]))
+            return undefined;
+        for (const [index, field] of RUN_FIELD_NAMES.entries()) {
+            if (candidate[field] !== record.values[index])
+                return undefined;
+        }
+        return record.normalized;
+    }
+    catch {
+        return undefined;
+    }
+}
+function rememberTrustedRecord(current, cacheKey, value, normalized) {
+    trustedRecords(current).set(cacheKey, trustedRecord(value, normalized));
+}
+function normalizeCachedRecord(current, cacheKey, value) {
+    const run = validateRun(value);
+    rememberTrustedRecord(current, cacheKey, value, run);
+    return run;
+}
+/** Register one current-session external job. pi-subagents never controls the job. */
+export function registerExternalRun(input) {
+    const run = validateRun(input);
+    const current = registry();
+    const runKey = key(run.sessionId, run.id);
+    if (current.runs.has(runKey))
+        throw new Error(`External run '${run.id}' is already registered for session '${run.sessionId}'.`);
+    if (current.runs.size >= EXTERNAL_RUN_LIMITS.maxCachedRuns)
+        throw new Error(`External-run registry supports at most ${EXTERNAL_RUN_LIMITS.maxCachedRuns} cached runs.`);
+    current.runs.set(runKey, run);
+    rememberTrustedRecord(current, runKey, run, run);
+    return clone(run);
+}
+/** Update display fields for a registered external job without changing its identity or owner. */
+export function updateExternalRun(sessionId, id, update) {
+    const safeSessionId = identity(sessionId, "External run sessionId", EXTERNAL_RUN_LIMITS.maxSessionIdLength);
+    const safeId = identity(id, "External run id");
+    const patch = inputObject(update, "External run update", UPDATE_FIELDS);
+    const current = registry();
+    const runKey = key(safeSessionId, safeId);
+    const previous = current.runs.get(runKey);
+    if (!previous)
+        throw new Error(`External run '${safeId}' is not registered for session '${safeSessionId}'.`);
+    const next = validateRun({ ...previous, ...patch });
+    current.runs.set(runKey, next);
+    rememberTrustedRecord(current, runKey, next, next);
+    return clone(next);
+}
+/** Remove a cached external job. The caller remains responsible for its process and artifacts. */
+export function unregisterExternalRun(sessionId, id) {
+    const current = registry();
+    const runKey = key(identity(sessionId, "External run sessionId", EXTERNAL_RUN_LIMITS.maxSessionIdLength), identity(id, "External run id"));
+    const deleted = current.runs.delete(runKey);
+    if (deleted)
+        trustedRecords(current).delete(runKey);
+    return deleted;
+}
+function snapshotBytes(runs) {
+    return Buffer.byteLength(JSON.stringify(runs), "utf8");
+}
+function getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** Read a bounded cached snapshot for one Pi session. This never invokes third-party code. */
+export function snapshotExternalRuns(sessionId, options = {}) {
+    const safeSessionId = identity(sessionId, "External-run snapshot sessionId", EXTERNAL_RUN_LIMITS.maxSessionIdLength);
+    const current = registry();
+    const trusted = trustedRecords(current);
+    const sessionPrefix = `${safeSessionId}\0`;
+    const runs = [];
+    for (const [cacheKey, value] of current.runs.entries()) {
+        if (typeof cacheKey !== "string" || !cacheKey.startsWith(sessionPrefix))
+            continue;
+        try {
+            const run = trustedRecordValue(value, trusted.get(cacheKey)) ?? normalizeCachedRecord(current, cacheKey, value);
+            if (run.sessionId === safeSessionId)
+                runs.push(run);
+        }
+        catch (error) {
+            const message = `Malformed cached external run '${cacheKey}': ${getErrorMessage(error)}`;
+            if (!options.ignoreMalformed)
+                throw new Error(message, { cause: error instanceof Error ? error : undefined });
+            current.runs.delete(cacheKey);
+            trusted.delete(cacheKey);
+            options.onMalformedRecord?.(message);
+        }
+    }
+    runs.sort((left, right) => {
+        const leftActive = left.state === "queued" || left.state === "running";
+        const rightActive = right.state === "queued" || right.state === "running";
+        if (leftActive !== rightActive)
+            return leftActive ? -1 : 1;
+        return (right.updatedAt ?? right.endedAt ?? right.startedAt) - (left.updatedAt ?? left.endedAt ?? left.startedAt) || left.id.localeCompare(right.id);
+    });
+    const snapshot = runs.slice(0, EXTERNAL_RUN_LIMITS.maxSnapshotRuns).map(clone);
+    while (snapshot.length > 0 && snapshotBytes(snapshot) > EXTERNAL_RUN_LIMITS.maxSerializedBytes)
+        snapshot.pop();
+    return snapshot;
+}
+/** Alias for callers that prefer list terminology. */
+export const listExternalRuns = snapshotExternalRuns;
+//# sourceMappingURL=external-runs.js.map

package/node_modules/pi-subagents/src/api/external-runs.js.map

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

package/node_modules/pi-subagents/src/api/inspectors.d.ts

@@ -0,0 +1,21 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { InspectorPlugin } from "../inspectors/types.ts";
+export type { InspectorContext, InspectorLaunch, InspectorParams, InspectorPlugin, InspectorTarget } from "../inspectors/types.ts";
+export declare const INSPECTOR_REGISTER_EVENT = "pi-subagents:inspector-register:v1";
+export interface InspectorRegistration {
+    dispose(): void;
+}
+export interface InspectorRegistrationRequest {
+    version: 1;
+    plugin: InspectorPlugin;
+    result?: {
+        ok: true;
+        registration: InspectorRegistration;
+    } | {
+        ok: false;
+        error: Error;
+    };
+}
+/** Register with the installed owner, even when each extension has its own module root. */
+export declare function registerInspector(pi: Pick<ExtensionAPI, "events">, plugin: InspectorPlugin): InspectorRegistration;
+//# sourceMappingURL=inspectors.d.ts.map

package/node_modules/pi-subagents/src/api/inspectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspectors.d.ts","sourceRoot":"","sources":["../../../src/api/inspectors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEnI,eAAO,MAAM,wBAAwB,uCAAuC,CAAC;AAE7E,MAAM,WAAW,qBAAqB;IACrC,OAAO,IAAI,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,4BAA4B;IAC5C,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EACJ;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,YAAY,EAAE,qBAAqB,CAAA;KAAE,GACjD;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC;CAC/B;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,eAAe,GAAG,qBAAqB,CAMlH"}

package/node_modules/pi-subagents/src/api/inspectors.js

@@ -0,0 +1,12 @@
+export const INSPECTOR_REGISTER_EVENT = "pi-subagents:inspector-register:v1";
+/** Register with the installed owner, even when each extension has its own module root. */
+export function registerInspector(pi, plugin) {
+    const request = { version: 1, plugin };
+    pi.events.emit(INSPECTOR_REGISTER_EVENT, request);
+    if (!request.result)
+        throw new Error("pi-subagents is not installed, not ready, or does not support inspector registration.");
+    if (!request.result.ok)
+        throw request.result.error;
+    return request.result.registration;
+}
+//# sourceMappingURL=inspectors.js.map

package/node_modules/pi-subagents/src/api/inspectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspectors.js","sourceRoot":"","sources":["../../../src/api/inspectors.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,wBAAwB,GAAG,oCAAoC,CAAC;AAc7E,2FAA2F;AAC3F,MAAM,UAAU,iBAAiB,CAAC,EAAgC,EAAE,MAAuB;IAC1F,MAAM,OAAO,GAAiC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACrE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,uFAAuF,CAAC,CAAC;IAC9H,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IACnD,OAAO,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC;AACpC,CAAC"}

package/node_modules/pi-subagents/src/api/intercom-bridge.d.ts

@@ -0,0 +1,2 @@
+export { resolveIntercomSessionTarget, } from "../intercom/intercom-bridge.ts";
+//# sourceMappingURL=intercom-bridge.d.ts.map

package/node_modules/pi-subagents/src/api/intercom-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intercom-bridge.d.ts","sourceRoot":"","sources":["../../../src/api/intercom-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,4BAA4B,GAC5B,MAAM,gCAAgC,CAAC"}

package/node_modules/pi-subagents/src/api/intercom-bridge.js

@@ -0,0 +1,2 @@
+export { resolveIntercomSessionTarget, } from "../intercom/intercom-bridge.js";
+//# sourceMappingURL=intercom-bridge.js.map

package/node_modules/pi-subagents/src/api/intercom-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intercom-bridge.js","sourceRoot":"","sources":["../../../src/api/intercom-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,4BAA4B,GAC5B,MAAM,gCAAgC,CAAC"}