@aexhq/sdk 0.46.5-canary → 0.50.0

package/dist/session-validate.js

@@ -1,303 +0,0 @@
-import { containsSecretLikeValue, redactString, SessionConfigValidationError } from "./_contracts/index.js";
-const SESSION_CREATE_KEYS = [
-    "model", "system", "assets", "mcpServers", "fileCapture",
-    "builtinTools", "outputMode", "responseFormat", "approvalGate", "metadata",
-    "idempotencyKey", "environment", "runtime", "overrides", "webhook"
-];
-const SESSION_START_KEYS = [
-    ...SESSION_CREATE_KEYS,
-    "message", "deleteAfter", "messageIdempotencyKey", "stream"
-];
-const START_CONTROL_KEYS = [
-    "timeoutMs", "webSocketFactory", "idleTimeoutMs", "pingIntervalMs", "throwOnFailure"
-];
-const SESSION_SEND_KEYS = [
-    "webSocketFactory", "idleTimeoutMs", "pingIntervalMs", "idempotencyKey"
-];
-const SESSION_STREAM_KEYS = [
-    "webSocketFactory", "idleTimeoutMs", "pingIntervalMs"
-];
-const SESSION_OVERRIDE_KEYS = [
-    "idleTtl", "timeout", "maxSpendUsd", "maxTurns"
-];
-const SESSION_RUNTIME_KEYS = ["kind", "size"];
-const FILE_CAPTURE_KEYS = [
-    "allowedDirs", "deniedDirs", "captureTimeoutMs", "maxFileBytes", "maxTotalBytes", "maxFiles"
-];
-const SESSION_WEBHOOK_KEYS = ["url"];
-const SESSION_ENVIRONMENT_KEYS = [
-    "networking", "packages", "variables", "secrets"
-];
-const PLATFORM_NETWORKING_KEYS = [
-    "mode", "allowedHosts"
-];
-const PLATFORM_PACKAGE_INPUT_KEYS = [
-    "name", "version"
-];
-const TEXT_RESPONSE_FORMAT_KEYS = ["kind"];
-const JSON_SCHEMA_RESPONSE_FORMAT_KEYS = [
-    "kind", "schema", "strict", "name"
-];
-const APPROVAL_GATE_KEYS = ["tools"];
-const ASSET_CATEGORY_KEYS = [
-    "files", "skills", "tools", "instructions"
-];
-const ASSET_ITEM_KEYS = {
-    files: [
-        "kind", "resourceId", "version", "assetId", "contentHash", "createdAt", "updatedAt",
-        "sizeBytes", "contentType", "name", "mountPath"
-    ],
-    skills: [
-        "kind", "resourceId", "version", "assetId", "contentHash", "createdAt", "updatedAt",
-        "sizeBytes", "contentType", "name", "description"
-    ],
-    tools: [
-        "kind", "resourceId", "version", "assetId", "contentHash", "createdAt", "updatedAt",
-        "sizeBytes", "contentType", "name", "description", "input_schema", "entry"
-    ],
-    instructions: [
-        "kind", "resourceId", "version", "assetId", "contentHash", "createdAt", "updatedAt",
-        "sizeBytes", "contentType", "name"
-    ]
-};
-const VALIDATION_DIAGNOSTIC_MAX_LENGTH = 512;
-const VALIDATION_DIAGNOSTIC_SOURCE_MAX_LENGTH = 4_096;
-const VALIDATION_DIAGNOSTIC_MAX_TOKENS = 64;
-const VALIDATION_DIAGNOSTIC_MAX_TOKEN_LENGTH = 1_024;
-function fallbackValidationDiagnostic(field) {
-    return `underlying validator rejected ${field}; diagnostic redacted`;
-}
-/**
- * Produce lossy diagnostic prose without retaining the caught value, its
- * properties, stack, or causal chain. Any uncertainty falls back to field-only
- * evidence rather than risking caller data in diagnostic-aware logging.
- */
-function safeValidationDiagnostic(caught, field, policy) {
-    const fallback = fallbackValidationDiagnostic(field);
-    if (policy.kind === "redacted")
-        return fallback;
-    try {
-        const values = Array.from(policy.rejectedValues);
-        if (values.length > VALIDATION_DIAGNOSTIC_MAX_TOKENS)
-            return fallback;
-        const tokens = values.filter((value) => typeof value === "string" && value.length > 0);
-        if (tokens.some((token) => token.length > VALIDATION_DIAGNOSTIC_MAX_TOKEN_LENGTH))
-            return fallback;
-        const raw = typeof caught === "string"
-            ? caught
-            : caught instanceof Error
-                ? caught.message
-                : undefined;
-        if (!raw)
-            return fallback;
-        let diagnostic = raw.slice(0, VALIDATION_DIAGNOSTIC_SOURCE_MAX_LENGTH);
-        for (const token of tokens) {
-            diagnostic = diagnostic.split(token).join("<redacted-value>");
-        }
-        diagnostic = diagnostic.replace(/[\u0000-\u001f\u007f-\u009f]+/g, " ");
-        diagnostic = redactString(diagnostic).trim();
-        if (diagnostic.length === 0 ||
-            containsSecretLikeValue(diagnostic) ||
-            tokens.some((token) => diagnostic.includes(token))) {
-            return fallback;
-        }
-        return diagnostic.length <= VALIDATION_DIAGNOSTIC_MAX_LENGTH
-            ? diagnostic
-            : `${diagnostic.slice(0, VALIDATION_DIAGNOSTIC_MAX_LENGTH - 3)}...`;
-    }
-    catch {
-        return fallback;
-    }
-}
-function validationDiagnosticError(message) {
-    const diagnostic = new Error(message);
-    Object.defineProperty(diagnostic, "name", {
-        configurable: true,
-        value: "SessionConfigDiagnosticError"
-    });
-    return diagnostic;
-}
-/** Package-private catch-and-translate owner for canonical session validators. */
-export function validatedSessionConfig(surface, field, message, validate, policy) {
-    try {
-        return validate();
-    }
-    catch (caught) {
-        throw configError(surface, field, message, validationDiagnosticError(safeValidationDiagnostic(caught, field, policy)));
-    }
-}
-/**
- * Package-private factory for SDK validation errors. `details.field` is the only
- * stable machine-readable payload; messages are human guidance and may change.
- */
-export function configError(surface, field, message, cause) {
-    return new SessionConfigValidationError(`${surface}: ${message}`, { field }, cause === undefined ? undefined : { cause });
-}
-export function normaliseSessionInput(input, surface, field) {
-    if (typeof input === "string") {
-        if (!input) {
-            throw configError(surface, field, `${field} must be a non-empty string`);
-        }
-        if (!input.trim()) {
-            throw configError(surface, field, `${field} must contain non-whitespace text`);
-        }
-        return input;
-    }
-    if (!Array.isArray(input) || input.length === 0) {
-        throw configError(surface, field, `${field} must be a non-empty string or string array`);
-    }
-    for (const segment of input) {
-        if (typeof segment !== "string" || !segment) {
-            throw configError(surface, field, `${field} segments must be non-empty strings`);
-        }
-    }
-    if (input.every((segment) => !segment.trim())) {
-        throw configError(surface, field, `${field} must contain non-whitespace text`);
-    }
-    return [...input];
-}
-export function assertSupportedSessionFields(options, surface, allowStartFields) {
-    const record = options;
-    const allowed = new Set(allowStartFields ? SESSION_START_KEYS : SESSION_CREATE_KEYS);
-    const guidance = {
-        runtimeSize: "use runtime.size",
-        runtimeKind: "use runtime.kind",
-        secretEnv: "use environment.secrets",
-        provider: "the serving provider is the model slug's creator prefix, e.g. model: \"anthropic/claude-haiku-4-5\"",
-        apiKeys: "model access is served on the aex managed gateway; you no longer supply a provider key",
-        parentSessionId: "subagent lineage is assigned by the platform",
-        message: "sessions are created without a first message; use Aex.start or session.messages.send",
-        prompt: "use message",
-        instructions: "publish Instructions through aex.workspace.instructions and pass the returned ref in assets.instructions"
-    };
-    for (const field of Object.keys(record)) {
-        if (!allowed.has(field)) {
-            const detail = guidance[field];
-            throw configError(surface, field, `${field} is not a supported option${detail === undefined ? "" : `; ${detail}`}`);
-        }
-    }
-    const overrides = record.overrides;
-    if (overrides && typeof overrides === "object" && !Array.isArray(overrides)) {
-        const overrideRecord = overrides;
-        if (Object.prototype.hasOwnProperty.call(overrideRecord, "idleSuspendAfter")) {
-            throw configError(surface, "overrides.idleSuspendAfter", "overrides.idleSuspendAfter is not a supported option; use overrides.idleTtl.");
-        }
-    }
-    const runtime = record.runtime;
-    if (runtime !== undefined) {
-        if (typeof runtime !== "object" || runtime === null || Array.isArray(runtime)) {
-            throw configError(surface, "runtime", "runtime must be an object like { kind, size }");
-        }
-        for (const key of Object.keys(runtime)) {
-            if (!SESSION_RUNTIME_KEYS.includes(key)) {
-                throw configError(surface, `runtime.${key}`, `runtime.${key} is not a supported option; use runtime.kind or runtime.size`);
-            }
-        }
-    }
-    assertStructuredSessionFields(record, surface, allowStartFields);
-}
-export function assertSupportedSessionSendOptions(options, surface, allowIdempotencyKey = true) {
-    const record = options;
-    if (!record || typeof record !== "object")
-        return;
-    const allowed = new Set(allowIdempotencyKey ? SESSION_SEND_KEYS : SESSION_STREAM_KEYS);
-    for (const field of Object.keys(record)) {
-        if (allowed.has(field))
-            continue;
-        const guidance = field === "from"
-            ? "use session.events.list(), stream(), or streamEnvelopes() for replay"
-            : field === "signal"
-                ? "use session.cancel() / session.suspend() for remote control"
-                : undefined;
-        throw configError(surface, field, `${field} is not a supported option${guidance === undefined ? "" : `; ${guidance}`}`);
-    }
-}
-export function assertStartSessionOptions(options, surface) {
-    assertAllowedObjectFields(options, surface, "options", START_CONTROL_KEYS);
-}
-function assertStructuredSessionFields(record, surface, allowStartFields) {
-    const overrides = assertAllowedObjectFields(record.overrides, surface, "overrides", SESSION_OVERRIDE_KEYS);
-    void overrides;
-    assertAssetsFields(record.assets, surface);
-    assertAllowedObjectFields(record.fileCapture, surface, "fileCapture", FILE_CAPTURE_KEYS);
-    assertEnvironmentFields(record.environment, surface);
-    assertAllowedObjectFields(record.webhook, surface, "webhook", SESSION_WEBHOOK_KEYS);
-    const responseFormat = assertRecord(record.responseFormat, surface, "responseFormat");
-    if (responseFormat !== undefined) {
-        const allowed = responseFormat.kind === "text"
-            ? TEXT_RESPONSE_FORMAT_KEYS
-            : JSON_SCHEMA_RESPONSE_FORMAT_KEYS;
-        assertAllowedKeys(responseFormat, surface, "responseFormat", allowed);
-    }
-    assertAllowedObjectFields(record.approvalGate, surface, "approvalGate", APPROVAL_GATE_KEYS);
-    if (allowStartFields) {
-        assertAllowedObjectFields(record.stream, surface, "stream", SESSION_STREAM_KEYS);
-    }
-}
-function assertAssetsFields(value, surface) {
-    const assets = assertAllowedObjectFields(value, surface, "assets", ASSET_CATEGORY_KEYS);
-    if (assets === undefined)
-        return;
-    // Workspace publish methods return records that extend the reusable ref with
-    // immutable metadata. Accept those records directly so publish -> session is ergonomic.
-    for (const category of ASSET_CATEGORY_KEYS) {
-        const allowed = ASSET_ITEM_KEYS[category];
-        const entries = assets[category];
-        if (entries === undefined)
-            continue;
-        if (!Array.isArray(entries)) {
-            throw configError(surface, `assets.${category}`, `assets.${category} must be an array`);
-        }
-        entries.forEach((entry, index) => {
-            const field = `assets.${category}[${index}]`;
-            const item = assertRecord(entry, surface, field);
-            if (item !== undefined)
-                assertAllowedKeys(item, surface, field, allowed);
-        });
-    }
-}
-function assertEnvironmentFields(value, surface) {
-    const environment = assertAllowedObjectFields(value, surface, "environment", SESSION_ENVIRONMENT_KEYS);
-    if (environment === undefined)
-        return;
-    assertAllowedObjectFields(environment.networking, surface, "environment.networking", PLATFORM_NETWORKING_KEYS);
-    for (const field of ["variables", "secrets"]) {
-        assertRecord(environment[field], surface, `environment.${field}`);
-    }
-    const packages = environment.packages;
-    if (packages === undefined)
-        return;
-    if (!Array.isArray(packages)) {
-        throw configError(surface, "environment.packages", "environment.packages must be an array");
-    }
-    packages.forEach((entry, index) => {
-        const field = `environment.packages[${index}]`;
-        const item = assertRecord(entry, surface, field);
-        if (item !== undefined)
-            assertAllowedKeys(item, surface, field, PLATFORM_PACKAGE_INPUT_KEYS);
-    });
-}
-export function assertAllowedObjectFields(value, surface, field, allowed) {
-    const record = assertRecord(value, surface, field);
-    if (record !== undefined)
-        assertAllowedKeys(record, surface, field, allowed);
-    return record;
-}
-function assertRecord(value, surface, field) {
-    if (value === undefined)
-        return undefined;
-    if (value === null || typeof value !== "object" || Array.isArray(value)) {
-        throw configError(surface, field, `${field} must be an object`);
-    }
-    return value;
-}
-function assertAllowedKeys(record, surface, field, allowed) {
-    const allowedSet = new Set(allowed);
-    for (const key of Object.keys(record)) {
-        if (allowedSet.has(key))
-            continue;
-        const nested = `${field}.${key}`;
-        throw configError(surface, nested, `${nested} is not a supported option`);
-    }
-}
-//# sourceMappingURL=session-validate.js.map

package/dist/session-validate.js.map

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

package/dist/skill.d.ts

@@ -1,99 +0,0 @@
-import { type FetchLike } from "./_contracts/index.js";
-import { type BundleMeta, type SkillFiles } from "./bundle.js";
-import type { IgnoreOptions } from "./node-walk.js";
-/**
- * A Skill is a draft workspace bundle of instructional /
- * executable content (`SKILL.md` at the bundle root plus any supporting files).
- * It is distinct from a {@link Tool}: a session gets a single `skills` meta-tool
- * (list/load) rather than one load-tool per skill.
- *
- * Factories read, canonically bundle, and hash local content. Publish the draft
- * with `aex.workspace.skills.publish(skill)`, then pin the returned immutable
- * resource ref in `assets.skills`.
- */
-export declare class Skill {
-    #private;
-    /** Internal constructor. Use the `Skill.from*` factories. */
-    private constructor();
-    /** Draft identity and canonical content hash. */
-    get ref(): DraftSkillRef;
-    /** True for a local-bytes skill that has not been upserted to the workspace yet. */
-    get isDraft(): boolean;
-    get name(): string;
-    get description(): string;
-    /**
-     * Read a local skill directory. It must contain `SKILL.md` at its root, whose
-     * YAML frontmatter supplies `description` and (unless `args.name` is given)
-     * `name`. When neither an explicit name nor a frontmatter name is present, the
-     * slugified directory basename is used.
-     *
-     * The directory is walked with FIDELITY (the same walk `File.fromPath` uses):
-     * `.aexignore` + the always-on defaults (`.git/`, `node_modules/`, …) prune the
-     * upload — so a skill dir carrying `node_modules` no longer ships it — and
-     * executable bits + symlinks are captured into a `.aexmeta.json` sidecar
-     * (emitted only when such metadata exists, so a pure-content skill dir stays
-     * byte-identical → dedup continuity). Bun/Node filesystem runtimes only.
-     */
-    static fromDir(rootDir: string, args?: {
-        readonly name?: string;
-        readonly ignore?: IgnoreOptions;
-    }): Promise<Skill>;
-    /**
-     * Fetch a zip-archived skill from a URL. The archive is downloaded in the SDK
-     * process (caller-controlled URL — no SSRF surface), optionally integrity-checked
-     * against `sha256`, and reduced to the same files map as `Skill.fromDir` (a
-     * single wrapping top-level folder is stripped). It must expose `SKILL.md` at
-     * the root. The signed URL only needs to be valid for this call.
-     */
-    static fromUrl(url: string, args?: {
-        readonly name?: string;
-        readonly sha256?: string;
-        readonly timeoutMs?: number;
-        readonly fetch?: FetchLike;
-    }): Promise<Skill>;
-    /**
-     * Build a draft skill from an in-memory files map (path -> string | bytes).
-     * Requires a root `SKILL.md`. Universal (no filesystem access). An optional
-     * `meta` (exec bits + symlinks) is threaded to the bundler for callers that
-     * carry fidelity metadata alongside a hand-built map; omit it and a plain map
-     * stays byte-identical to the pre-fidelity output.
-     */
-    static fromFiles(args: {
-        readonly name?: string;
-        readonly files: SkillFiles;
-        readonly meta?: BundleMeta;
-    }): Promise<Skill>;
-    /** Convenience: build a single-file skill from a `SKILL.md` string. */
-    static fromContent(skillMd: string, args?: {
-        readonly name?: string;
-    }): Promise<Skill>;
-    /**
-     * Build a draft skill from an already-zipped bundle. The zip is unpacked to a
-     * files map (directory entries dropped), then re-canonicalised so a
-     * `fromBytes` skill and the identical `fromDir` / `fromFiles` skill dedup by
-     * content hash. Requires `SKILL.md` at the archive root.
-     */
-    static fromBytes(args: {
-        readonly name?: string;
-        readonly zip: Uint8Array;
-    }): Promise<Skill>;
-    /**
-     * Internal: yield the draft bytes and metadata to the workspace publisher.
-     */
-    _takeDraftBundle(): {
-        name: string;
-        description: string;
-        contentHash: string;
-        bytes: Uint8Array;
-    };
-    toJSON(): never;
-}
-/**
- * SDK-internal draft marker. It never reaches the session wire directly.
- */
-export interface DraftSkillRef {
-    readonly kind: "draft";
-    readonly name: string;
-    readonly description: string;
-    readonly contentHash: string;
-}

package/dist/skill.js

@@ -1,169 +0,0 @@
-import { SKILL_BUNDLE_LIMITS } from "./_contracts/index.js";
-import { deriveSkillName, extractSkillFrontmatter } from "./_contracts/internal.js";
-import { bundleSkillFiles, hashSkillBundle, splitSkillBundleMetadata } from "./bundle.js";
-import { fetchSkillArchive } from "./fetch-archive.js";
-import { readDirectoryWithFidelity } from "./node-fs.js";
-import { unzipSync } from "fflate";
-import { assertArchiveCompressedSize, assertArchiveExpandedSize } from "./archive-limits.js";
-import { crossPlatformBasename } from "./path-basename.js";
-/**
- * A Skill is a draft workspace bundle of instructional /
- * executable content (`SKILL.md` at the bundle root plus any supporting files).
- * It is distinct from a {@link Tool}: a session gets a single `skills` meta-tool
- * (list/load) rather than one load-tool per skill.
- *
- * Factories read, canonically bundle, and hash local content. Publish the draft
- * with `aex.workspace.skills.publish(skill)`, then pin the returned immutable
- * resource ref in `assets.skills`.
- */
-export class Skill {
-    #ref;
-    #description;
-    #bundleBytes;
-    /** Internal constructor. Use the `Skill.from*` factories. */
-    constructor(ref, description, bundleBytes) {
-        this.#ref = ref;
-        this.#description = description;
-        this.#bundleBytes = bundleBytes;
-    }
-    /** Draft identity and canonical content hash. */
-    get ref() {
-        return this.#ref;
-    }
-    /** True for a local-bytes skill that has not been upserted to the workspace yet. */
-    get isDraft() {
-        return true;
-    }
-    get name() {
-        return this.#ref.name;
-    }
-    get description() {
-        return this.#description;
-    }
-    // --- factories (source symmetry with File / Instructions / Tool) --------------
-    /**
-     * Read a local skill directory. It must contain `SKILL.md` at its root, whose
-     * YAML frontmatter supplies `description` and (unless `args.name` is given)
-     * `name`. When neither an explicit name nor a frontmatter name is present, the
-     * slugified directory basename is used.
-     *
-     * The directory is walked with FIDELITY (the same walk `File.fromPath` uses):
-     * `.aexignore` + the always-on defaults (`.git/`, `node_modules/`, …) prune the
-     * upload — so a skill dir carrying `node_modules` no longer ships it — and
-     * executable bits + symlinks are captured into a `.aexmeta.json` sidecar
-     * (emitted only when such metadata exists, so a pure-content skill dir stays
-     * byte-identical → dedup continuity). Bun/Node filesystem runtimes only.
-     */
-    static async fromDir(rootDir, args = {}) {
-        const { files, meta } = await readDirectoryWithFidelity(rootDir, args.ignore);
-        return Skill.#fromFiles("Skill.fromDir", files, args.name, crossPlatformBasename(rootDir), meta);
-    }
-    /**
-     * Fetch a zip-archived skill from a URL. The archive is downloaded in the SDK
-     * process (caller-controlled URL — no SSRF surface), optionally integrity-checked
-     * against `sha256`, and reduced to the same files map as `Skill.fromDir` (a
-     * single wrapping top-level folder is stripped). It must expose `SKILL.md` at
-     * the root. The signed URL only needs to be valid for this call.
-     */
-    static async fromUrl(url, args = {}) {
-        const { files, meta } = await fetchSkillArchive(url, {
-            ...(args.sha256 !== undefined ? { sha256: args.sha256 } : {}),
-            ...(args.timeoutMs !== undefined ? { timeoutMs: args.timeoutMs } : {}),
-            ...(args.fetch !== undefined ? { fetch: args.fetch } : {})
-        });
-        // A URL has no reliable directory basename, so no slug fallback.
-        return Skill.#fromFiles("Skill.fromUrl", files, args.name, undefined, meta);
-    }
-    /**
-     * Build a draft skill from an in-memory files map (path -> string | bytes).
-     * Requires a root `SKILL.md`. Universal (no filesystem access). An optional
-     * `meta` (exec bits + symlinks) is threaded to the bundler for callers that
-     * carry fidelity metadata alongside a hand-built map; omit it and a plain map
-     * stays byte-identical to the pre-fidelity output.
-     */
-    static async fromFiles(args) {
-        if (!args || typeof args !== "object" || args.files === undefined) {
-            throw new Error("Skill.fromFiles: { files } is required");
-        }
-        return Skill.#fromFiles("Skill.fromFiles", args.files, args.name, undefined, args.meta);
-    }
-    /** Convenience: build a single-file skill from a `SKILL.md` string. */
-    static async fromContent(skillMd, args = {}) {
-        if (typeof skillMd !== "string" || skillMd.length === 0) {
-            throw new Error("Skill.fromContent: skillMd must be a non-empty string");
-        }
-        return Skill.#fromFiles("Skill.fromContent", { "SKILL.md": skillMd }, args.name, undefined);
-    }
-    /**
-     * Build a draft skill from an already-zipped bundle. The zip is unpacked to a
-     * files map (directory entries dropped), then re-canonicalised so a
-     * `fromBytes` skill and the identical `fromDir` / `fromFiles` skill dedup by
-     * content hash. Requires `SKILL.md` at the archive root.
-     */
-    static async fromBytes(args) {
-        if (!args || !(args.zip instanceof Uint8Array) || args.zip.byteLength === 0) {
-            throw new Error("Skill.fromBytes: { zip } must be a non-empty Uint8Array");
-        }
-        assertArchiveCompressedSize(args.zip.byteLength, "Skill.fromBytes");
-        let entries;
-        let fileCount = 0;
-        let expandedBytes = 0;
-        try {
-            entries = unzipSync(args.zip, {
-                filter: (entry) => {
-                    if (/[\\/]$/.test(entry.name))
-                        return false;
-                    fileCount += 1;
-                    if (fileCount > SKILL_BUNDLE_LIMITS.maxFiles + 1) {
-                        throw new Error(`Skill.fromBytes exceeds the ${SKILL_BUNDLE_LIMITS.maxFiles}-entry limit plus one control record`);
-                    }
-                    expandedBytes += entry.originalSize;
-                    assertArchiveExpandedSize(expandedBytes, "Skill.fromBytes");
-                    return true;
-                }
-            });
-        }
-        catch (err) {
-            throw new Error(`Skill.fromBytes: could not unzip the bundle (expected a .zip): ${err.message}`);
-        }
-        const files = {};
-        for (const [rawPath, bytes] of Object.entries(entries)) {
-            const path = rawPath.replace(/\\/g, "/");
-            if (path.endsWith("/"))
-                continue; // directory entry
-            files[path] = bytes;
-        }
-        const parsed = splitSkillBundleMetadata(files, "Skill.fromBytes");
-        return Skill.#fromFiles("Skill.fromBytes", parsed.files, args.name, undefined, parsed.meta);
-    }
-    /**
-     * Internal: yield the draft bytes and metadata to the workspace publisher.
-     */
-    _takeDraftBundle() {
-        return {
-            name: this.#ref.name,
-            description: this.#ref.description,
-            contentHash: this.#ref.contentHash,
-            bytes: this.#bundleBytes
-        };
-    }
-    toJSON() {
-        throw new Error("Skill drafts cannot be submitted directly; publish with aex.workspace.skills.publish(...)");
-    }
-    static async #fromFiles(source, files, explicitName, dirBasename, meta) {
-        const front = extractSkillFrontmatter(source, files);
-        const name = deriveSkillName(source, front.name, explicitName, dirBasename);
-        const description = front.description;
-        if (typeof description !== "string" || description.trim().length === 0) {
-            throw new Error(`${source}: a skill description is required — add a \`description:\` field to the SKILL.md YAML frontmatter`);
-        }
-        if (description.length > 2048) {
-            throw new Error(`${source}: description must be <= 2048 chars`);
-        }
-        const bundled = bundleSkillFiles(files, meta);
-        const contentHash = await hashSkillBundle(bundled.zip);
-        const ref = { kind: "draft", name, description, contentHash };
-        return new Skill(ref, description, bundled.zip);
-    }
-}
-//# sourceMappingURL=skill.js.map

package/dist/skill.js.map

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

package/dist/submission-wire.d.ts

@@ -1,13 +0,0 @@
-import type { McpServerRef, PlatformEnvironmentInput, PlatformMcpServerSecret, PlatformSubmission, SessionRetentionPolicy } from "./_contracts/index.js";
-import type { SessionCreateOptions, SessionEnvironmentOptions } from "./client-types.js";
-import { McpServer } from "./mcp-server.js";
-export declare function fileCaptureForWire(fileCapture: SessionCreateOptions["fileCapture"]): PlatformSubmission["fileCapture"] | undefined;
-export declare function sessionRetentionForWire(options: SessionCreateOptions): SessionRetentionPolicy;
-export declare function sessionEnvironmentForWire(environment: SessionEnvironmentOptions | undefined): PlatformEnvironmentInput | undefined;
-export declare function mergeMcpServers(inputs: readonly McpServer[], explicitSecrets: readonly PlatformMcpServerSecret[]): {
-    submissionMcpServers: ReadonlyArray<McpServerRef | {
-        readonly kind: "workspace";
-        readonly id: string;
-    }>;
-    mergedMcpSecrets: readonly PlatformMcpServerSecret[];
-};