@gonovus-ai/spec-flow-cli 0.5.0 → 0.6.0

package/dist/input/text-source.js

@@ -0,0 +1,74 @@
+import { CommanderError, InvalidArgumentError } from "commander";
+import { constants } from "node:fs";
+import { open, stat } from "node:fs/promises";
+const maximumBytes = 80_000;
+/** Commander must not silently overwrite an earlier source selection. */
+export function singleDescriptionSource(value, previous) {
+    if (previous !== undefined)
+        throw new CommanderError(2, "specflow.duplicateDescriptionSource", "Choose one description source; repeated description options are not allowed");
+    return value;
+}
+/** Read only an explicitly selected source, preserving its bytes as UTF-8 text. */
+export async function readDescription(source) {
+    if (Number(source.description !== undefined) + Number(source.descriptionFile !== undefined) + Number(source.clearDescription === true) > 1) {
+        throw new InvalidArgumentError("Choose one description source: inline, file/stdin, or clear");
+    }
+    if (source.clearDescription === true)
+        return null;
+    let text = source.description;
+    if (source.descriptionFile !== undefined) {
+        try {
+            let bytes;
+            if (source.descriptionFile === "-") {
+                if (process.stdin.isTTY)
+                    throw new Error("tty");
+                const chunks = [];
+                let length = 0;
+                for await (const chunk of process.stdin) {
+                    const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk));
+                    length += buffer.length;
+                    if (length > maximumBytes)
+                        throw new Error("size");
+                    chunks.push(buffer);
+                }
+                bytes = Buffer.concat(chunks);
+            }
+            else {
+                const before = await stat(source.descriptionFile);
+                if (!before.isFile() || before.size > maximumBytes)
+                    throw new Error("file");
+                // NONBLOCK prevents a replacement FIFO from blocking open; fstat and inode
+                // comparison reject replacements between the path check and opening.
+                const file = await open(source.descriptionFile, constants.O_RDONLY | constants.O_NONBLOCK);
+                try {
+                    const after = await file.stat();
+                    if (!after.isFile() || after.dev !== before.dev || after.ino !== before.ino || after.size > maximumBytes)
+                        throw new Error("file");
+                    const buffer = Buffer.alloc(maximumBytes + 1);
+                    let length = 0;
+                    while (length < buffer.length) {
+                        const result = await file.read(buffer, length, buffer.length - length, length);
+                        if (result.bytesRead === 0)
+                            break;
+                        length += result.bytesRead;
+                    }
+                    if (length > maximumBytes)
+                        throw new Error("size");
+                    bytes = buffer.subarray(0, length);
+                }
+                finally {
+                    await file.close();
+                }
+            }
+            text = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true }).decode(bytes);
+        }
+        catch {
+            throw new InvalidArgumentError("Description source must be a regular UTF-8 file of at most 80000 bytes; for stdin use a pipe with --description-file - (no TTY)");
+        }
+    }
+    if (text !== undefined && (text.trim().length === 0 || text.trim().length > 20_000)) {
+        throw new InvalidArgumentError("Description must contain 1 to 20000 UTF-16 code units after trimming");
+    }
+    return text;
+}
+//# sourceMappingURL=text-source.js.map

package/dist/input/text-source.js.map

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

package/dist/program.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+import type { CliDependencies } from "./cli.js";
+export declare function createProgram(dependencies: Pick<CliDependencies, "stdout">): Command;

package/dist/program.js

@@ -0,0 +1,19 @@
+import { Command, InvalidArgumentError } from "commander";
+import { specFlowCliVersion } from "./user-agent.js";
+export function createProgram(dependencies) {
+    return new Command()
+        .name("specflow")
+        .version(specFlowCliVersion)
+        .description("Read and govern SpecFlow through supported commands")
+        .option("--allow-file-fallback", "use a warned owner-only local credential file if the system store is unavailable")
+        .option("--server <url>", "SpecFlow server origin")
+        .option("--output <mode>", "JSON output: full or summary (supported Work Item commands only)", (value) => { if (value !== "full" && value !== "summary")
+        throw new InvalidArgumentError("Output must be full or summary"); return value; })
+        .option("--api-key-id <id>", "Use an origin-scoped User API Key from the credential store")
+        .exitOverride()
+        .configureOutput({
+        writeErr: () => undefined,
+        writeOut: dependencies.stdout,
+    });
+}
+//# sourceMappingURL=program.js.map

package/dist/program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAG1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,UAAU,aAAa,CAAC,YAA6C;IACzE,OAAO,IAAI,OAAO,EAAE;SACjB,IAAI,CAAC,UAAU,CAAC;SAChB,OAAO,CAAC,kBAAkB,CAAC;SAC3B,WAAW,CAAC,qDAAqD,CAAC;SAClE,MAAM,CACL,uBAAuB,EACvB,kFAAkF,CACnF;SACA,MAAM,CAAC,gBAAgB,EAAE,wBAAwB,CAAC;SAClD,MAAM,CAAC,iBAAiB,EAAE,kEAAkE,EAAE,CAAC,KAAa,EAAE,EAAE,GAAG,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,oBAAoB,CAAC,gCAAgC,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;SAClP,MAAM,CAAC,mBAAmB,EAAE,6DAA6D,CAAC;SAC1F,YAAY,EAAE;SACd,eAAe,CAAC;QACf,QAAQ,EAAE,GAAG,EAAE,CAAC,SAAS;QACzB,QAAQ,EAAE,YAAY,CAAC,MAAM;KAC9B,CAAC,CAAC;AACP,CAAC"}

package/dist/runtime/errors.d.ts

@@ -0,0 +1,28 @@
+import type { CliDependencies } from "../cli.js";
+export declare function mapHttpFailure(response: Response, payload: unknown): SkillError;
+type SkillErrorReason = "Authentication Failed" | "Invalid Operation" | "Permission Denied" | "Project Not Accessible" | "Resource Changed" | "Resource Not Found" | "Temporary Failure";
+interface SkillErrorDiagnostic {
+    readonly column?: number;
+    readonly line?: number;
+    readonly message: string;
+    readonly reason: string;
+}
+export interface SkillError {
+    readonly requestId?: string;
+    readonly code?: string;
+    readonly status?: number;
+    readonly issues?: readonly {
+        readonly location: string;
+        readonly path: readonly (string | number)[];
+        readonly rule: string;
+        readonly message: string;
+    }[];
+    readonly diagnostics?: readonly SkillErrorDiagnostic[];
+    readonly message: string;
+    readonly reason: SkillErrorReason;
+    readonly retryAfter?: string;
+    readonly retryable: boolean;
+}
+export declare function skillErrorExitCode(error: SkillError): number;
+export declare function writeSkillError(dependencies: CliDependencies, error: SkillError): void;
+export {};

package/dist/runtime/errors.js

@@ -0,0 +1,133 @@
+import { z } from "zod";
+export function mapHttpFailure(response, payload) {
+    const failure = classifyHttpFailure(response, payload);
+    const issues = z.array(z.object({ location: z.enum(["body", "query", "path", "headers", "tool"]), path: z.array(z.union([z.string().max(100), z.number()])), rule: z.string().max(100), message: z.string().max(500) })).max(20).safeParse(z.object({ issues: z.unknown() }).safeParse(payload).data?.issues);
+    const code = readServerCode(payload);
+    const requestId = response.headers.get("x-request-id");
+    return { ...failure, ...(requestId !== null && /^[A-Za-z0-9._:-]{1,100}$/u.test(requestId) ? { requestId } : {}), status: response.status, ...(code !== null && /^[A-Z][A-Z0-9_]{0,79}$/u.test(code) ? { code } : {}), ...(issues.success ? { issues: issues.data } : {}) };
+}
+function classifyHttpFailure(response, payload) {
+    const { status } = response;
+    const serverMessage = readServerMessage(payload);
+    const serverCode = readServerCode(payload);
+    if (status === 404 && serverCode === "IDENTITY_NOT_SUPPORTED") {
+        return { message: serverMessage ?? "This server does not support current identity", reason: "Invalid Operation", retryable: false };
+    }
+    if (status === 401) {
+        return {
+            message: serverMessage ?? "Workspace read-only Token is invalid, expired, or revoked",
+            reason: "Authentication Failed",
+            retryable: false,
+        };
+    }
+    if (status === 403) {
+        return {
+            message: serverMessage ?? "Workspace read-only Token does not permit this operation",
+            reason: "Permission Denied",
+            retryable: false,
+        };
+    }
+    if (status === 404) {
+        if (serverCode === "PROJECT_NOT_ACCESSIBLE") {
+            return {
+                message: serverMessage ?? "The Project is not accessible",
+                reason: "Project Not Accessible",
+                retryable: false,
+            };
+        }
+        return {
+            message: serverMessage ?? "The requested Project resource was not found",
+            reason: "Resource Not Found",
+            retryable: false,
+        };
+    }
+    if (status === 409 && serverCode === "RESOURCE_CHANGED") {
+        return {
+            message: serverMessage ?? "The Working Draft changed after the Proposal baseline",
+            reason: "Resource Changed",
+            retryable: false,
+        };
+    }
+    if (status === 400 || status === 409 || status === 413 || status === 422 || status === 428) {
+        const diagnostics = readServerDiagnostics(payload);
+        return {
+            ...(diagnostics === undefined ? {} : { diagnostics }),
+            message: serverMessage ?? "The requested operation is invalid",
+            reason: "Invalid Operation",
+            retryable: false,
+        };
+    }
+    if (status === 412) {
+        return {
+            message: serverMessage ?? "The resource changed after it was read",
+            reason: "Resource Changed",
+            retryable: false,
+        };
+    }
+    if (status === 429) {
+        const retryAfter = response.headers.get("retry-after");
+        return {
+            message: serverMessage ?? "SpecFlow is temporarily throttling this client",
+            reason: "Temporary Failure",
+            ...(retryAfter === null ? {} : { retryAfter }),
+            retryable: true,
+        };
+    }
+    return {
+        message: serverMessage ?? "SpecFlow is temporarily unavailable",
+        reason: "Temporary Failure",
+        retryable: status >= 500,
+    };
+}
+function readServerMessage(payload) {
+    return typeof payload === "object" &&
+        payload !== null &&
+        "message" in payload &&
+        typeof payload.message === "string"
+        ? payload.message
+        : null;
+}
+function readServerCode(payload) {
+    return typeof payload === "object" &&
+        payload !== null &&
+        "code" in payload &&
+        typeof payload.code === "string"
+        ? payload.code
+        : null;
+}
+function readServerDiagnostics(payload) {
+    if (typeof payload !== "object" ||
+        payload === null ||
+        !("diagnostics" in payload) ||
+        !Array.isArray(payload.diagnostics)) {
+        return undefined;
+    }
+    const diagnostics = payload.diagnostics.flatMap((entry) => {
+        if (typeof entry !== "object" || entry === null) {
+            return [];
+        }
+        const { column, line, message, reason } = entry;
+        if (typeof reason !== "string" || typeof message !== "string") {
+            return [];
+        }
+        return [
+            {
+                ...(typeof column === "number" ? { column } : {}),
+                ...(typeof line === "number" ? { line } : {}),
+                message,
+                reason,
+            },
+        ];
+    });
+    return diagnostics.length === 0 ? undefined : diagnostics;
+}
+export function skillErrorExitCode(error) {
+    if (error.reason === "Permission Denied") {
+        return 3;
+    }
+    return error.reason === "Temporary Failure" ? 4 : 2;
+}
+export function writeSkillError(dependencies, error) {
+    dependencies.stderr(`${JSON.stringify({ error })}\n`);
+}
+//# sourceMappingURL=errors.js.map

package/dist/runtime/errors.js.map

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

package/dist/runtime/execute.d.ts

@@ -0,0 +1,23 @@
+import type createClient from "openapi-fetch";
+import type { paths } from "@spec-flow/api-client";
+import { type SkillError } from "./errors.js";
+export interface ApiResult<T> {
+    readonly data?: T;
+    readonly error?: unknown;
+    readonly response: Response;
+}
+export interface ExecuteOptions {
+    readonly ambiguousOutcomeMessage?: string;
+    readonly rejectWorkspaceReadToken?: boolean;
+    readonly requireUserSession?: boolean;
+    readonly retryTransportOnce?: boolean;
+    readonly validateSuccess?: (data: unknown) => SkillError | null;
+}
+export type ExecutionResult<T> = {
+    readonly ok: true;
+    readonly data: T;
+} | {
+    readonly ok: false;
+    readonly error: SkillError;
+};
+export declare function execute<T>(request: (client: ReturnType<typeof createClient<paths>>) => Promise<ApiResult<T>>, client: ReturnType<typeof createClient<paths>>, options?: ExecuteOptions): Promise<ExecutionResult<T>>;

package/dist/runtime/execute.js

@@ -0,0 +1,25 @@
+import { mapHttpFailure } from "./errors.js";
+export async function execute(request, client, options = {}) {
+    let result;
+    try {
+        result = await request(client);
+    }
+    catch {
+        return { ok: false, error: options.retryTransportOnce === true ? ambiguousMutationError(options.ambiguousOutcomeMessage) : { message: "SpecFlow is temporarily unavailable", reason: "Temporary Failure", retryable: true } };
+    }
+    if (result.response.ok && result.data !== undefined) {
+        const error = options.validateSuccess?.(result.data) ?? null;
+        return error === null ? { ok: true, data: result.data } : { ok: false, error };
+    }
+    return { ok: false, error: result.response.ok && options.retryTransportOnce === true ? ambiguousMutationError(options.ambiguousOutcomeMessage) : mapHttpFailure(result.response, result.error) };
+}
+function ambiguousMutationError(message) {
+    return {
+        message: message ??
+            "Write outcome is unknown; read the target resource before trying a new command identity",
+        code: "EXECUTION_OUTCOME_UNKNOWN",
+        reason: "Temporary Failure",
+        retryable: false,
+    };
+}
+//# sourceMappingURL=execute.js.map

package/dist/runtime/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/runtime/execute.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAmB,MAAM,aAAa,CAAC;AAW9D,MAAM,CAAC,KAAK,UAAU,OAAO,CAAI,OAAkF,EAAE,MAA8C,EAAE,UAA0B,EAAE;IAC/L,IAAI,MAAoB,CAAC;IACzB,IAAI,CAAC;QAAC,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAAC,CAAC;IACvC,MAAM,CAAC;QAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,kBAAkB,KAAK,IAAI,CAAC,CAAC,CAAC,sBAAsB,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,MAAM,EAAE,mBAAmB,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;IAAC,CAAC;IACxO,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;QAC7D,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACjF,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,OAAO,CAAC,kBAAkB,KAAK,IAAI,CAAC,CAAC,CAAC,sBAAsB,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACnM,CAAC;AACD,SAAS,sBAAsB,CAAC,OAAgB;IAC9C,OAAO;QACL,OAAO,EACL,OAAO;YACP,yFAAyF;QAC3F,IAAI,EAAE,2BAA2B;QACjC,MAAM,EAAE,mBAAmB;QAC3B,SAAS,EAAE,KAAK;KACjB,CAAC;AACJ,CAAC"}

package/dist/runtime/identity.d.ts

@@ -0,0 +1,183 @@
+import type createClient from "openapi-fetch";
+import type { paths } from "@spec-flow/api-client";
+export declare function readIdentity(client: ReturnType<typeof createClient<paths>>): Promise<import("openapi-fetch").FetchResponse<{
+    parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+        200: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": {
+                    user: {
+                        id: string;
+                    };
+                };
+            };
+        };
+        400: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": {
+                    code: string;
+                    message: string;
+                    issues?: {
+                        location: "body" | "query" | "path" | "headers" | "tool";
+                        path: (string | number)[];
+                        rule: string;
+                        message: string;
+                    }[];
+                };
+            };
+        };
+        401: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": {
+                    code: string;
+                    message: string;
+                    issues?: {
+                        location: "body" | "query" | "path" | "headers" | "tool";
+                        path: (string | number)[];
+                        rule: string;
+                        message: string;
+                    }[];
+                };
+            };
+        };
+        403: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": {
+                    code: string;
+                    message: string;
+                    issues?: {
+                        location: "body" | "query" | "path" | "headers" | "tool";
+                        path: (string | number)[];
+                        rule: string;
+                        message: string;
+                    }[];
+                };
+            };
+        };
+        503: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": {
+                    code: string;
+                    message: string;
+                    issues?: {
+                        location: "body" | "query" | "path" | "headers" | "tool";
+                        path: (string | number)[];
+                        rule: string;
+                        message: string;
+                    }[];
+                };
+            };
+        };
+    };
+}, import("openapi-fetch").FetchOptions<{
+    parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+        200: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": {
+                    user: {
+                        id: string;
+                    };
+                };
+            };
+        };
+        400: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": {
+                    code: string;
+                    message: string;
+                    issues?: {
+                        location: "body" | "query" | "path" | "headers" | "tool";
+                        path: (string | number)[];
+                        rule: string;
+                        message: string;
+                    }[];
+                };
+            };
+        };
+        401: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": {
+                    code: string;
+                    message: string;
+                    issues?: {
+                        location: "body" | "query" | "path" | "headers" | "tool";
+                        path: (string | number)[];
+                        rule: string;
+                        message: string;
+                    }[];
+                };
+            };
+        };
+        403: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": {
+                    code: string;
+                    message: string;
+                    issues?: {
+                        location: "body" | "query" | "path" | "headers" | "tool";
+                        path: (string | number)[];
+                        rule: string;
+                        message: string;
+                    }[];
+                };
+            };
+        };
+        503: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": {
+                    code: string;
+                    message: string;
+                    issues?: {
+                        location: "body" | "query" | "path" | "headers" | "tool";
+                        path: (string | number)[];
+                        rule: string;
+                        message: string;
+                    }[];
+                };
+            };
+        };
+    };
+}> | undefined, `${string}/${string}`>>;

package/dist/runtime/identity.js

@@ -0,0 +1,17 @@
+import { z } from "zod";
+const identitySchema = z.object({ user: z.object({ id: z.string().min(1) }) });
+export async function readIdentity(client) {
+    const result = await client.GET("/v1/identity");
+    // Only Fastify's recognizable missing-route response means an older API.
+    // Authorization failures and resource 404s retain their ordinary categories.
+    const payload = result.error;
+    const missingRoute = z.object({ message: z.literal("Route GET:/v1/identity not found"), error: z.literal("Not Found"), statusCode: z.literal(404) }).safeParse(payload).success;
+    const missingCode = typeof payload === "object" && payload !== null && "code" in payload && payload.code === "FST_ERR_NOT_FOUND";
+    if (result.response.status === 404 && (missingRoute || missingCode)) {
+        return { response: result.response, error: { code: "IDENTITY_NOT_SUPPORTED", message: "This server version does not support current identity; upgrade the server or provide a User ID" } };
+    }
+    if (result.response.ok && !identitySchema.safeParse(result.data).success)
+        throw new Error("Invalid current identity response");
+    return result;
+}
+//# sourceMappingURL=identity.js.map

package/dist/runtime/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/runtime/identity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAA+B,CAAC;AAE7G,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAA8C;IAC/E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAChD,yEAAyE;IACzE,6EAA6E;IAC7E,MAAM,OAAO,GAAY,MAAM,CAAC,KAAK,CAAC;IACtC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,kCAAkC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;IAChL,MAAM,WAAW,GAAG,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,MAAM,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,mBAAmB,CAAC;IACjI,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,IAAI,WAAW,CAAC,EAAE,CAAC;QACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,gGAAgG,EAAE,EAAE,CAAC;IAC7L,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC/H,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/runtime/output.d.ts

@@ -0,0 +1,3 @@
+import type { CliDependencies } from "../cli.js";
+/** Local failures never enter transport retry or claim that a write failed. */
+export declare function writeResult(dependencies: CliDependencies, project: () => unknown): number;

package/dist/runtime/output.js

@@ -0,0 +1,13 @@
+import { writeSkillError } from "./errors.js";
+/** Local failures never enter transport retry or claim that a write failed. */
+export function writeResult(dependencies, project) {
+    try {
+        dependencies.stdout(`${JSON.stringify(project())}\n`);
+        return 0;
+    }
+    catch {
+        writeSkillError(dependencies, { code: "LOCAL_OUTPUT_FAILED", message: "The result could not be written locally; the server operation may have completed. Read the resource before retrying", reason: "Temporary Failure", retryable: false });
+        return 4;
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/runtime/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/runtime/output.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CAAC,YAA6B,EAAE,OAAsB;IAC/E,IAAI,CAAC;QACH,YAAY,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;QACtD,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,MAAM,CAAC;QACP,eAAe,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,qHAAqH,EAAE,MAAM,EAAE,mBAAmB,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9O,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/runtime/session.d.ts

@@ -0,0 +1,16 @@
+import type { paths } from "@spec-flow/api-client";
+import type { CliDependencies } from "../cli.js";
+import type { ExecuteOptions } from "./execute.js";
+export declare function selectSession(dependencies: CliDependencies, options: ExecuteOptions, serverFlag?: unknown, apiKeyIdFlag?: unknown): Promise<{
+    exitCode: number;
+    client?: never;
+    identityClient?: never;
+    credentialKind?: never;
+} | {
+    client: import("openapi-fetch").Client<paths, `${string}/${string}`>;
+    identityClient: import("openapi-fetch").Client<paths, `${string}/${string}`>;
+    credentialKind: "api-key" | "workspace-read-token" | "session";
+    exitCode?: never;
+}>;
+export declare function rejectWorkspaceReadTokenOperation(dependencies: CliDependencies): number;
+export declare function hasWorkspaceReadToken(environment: Readonly<Record<string, string | undefined>>): boolean;