@agentxm/client-core 0.1.6

package/dist/src/unstable/subagents/rendering/tool-access-mapping.js

@@ -0,0 +1,169 @@
+/**
+ * Tool access mapping for subagent rendering.
+ *
+ * Maps portable `toolAccess` values to agent-native tool control fields.
+ * Returns an object of fields to merge into the rendered output.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+/**
+ * Per-agent tool access mapping definitions.
+ */
+const TOOL_ACCESS_TABLE = {
+    "claude-code": {
+        full: { fields: {}, warnings: [] },
+        readonly: {
+            fields: { disallowedTools: "Edit,Write,Bash" },
+            warnings: [],
+        },
+        none: {
+            fields: { tools: "" },
+            warnings: [],
+        },
+    },
+    "github-copilot": {
+        full: { fields: { tools: ["*"] }, warnings: [] },
+        readonly: {
+            fields: { tools: ["read", "search"] },
+            warnings: [],
+        },
+        none: {
+            fields: { tools: [] },
+            warnings: [],
+        },
+    },
+    codex: {
+        full: { fields: {}, warnings: [] },
+        readonly: {
+            fields: { sandbox_mode: "read-only" },
+            warnings: [],
+        },
+        none: {
+            fields: { sandbox_mode: "read-only" },
+            warnings: [
+                {
+                    agent: "codex",
+                    feature: "toolAccess",
+                    message: 'Codex does not distinguish "none" from "readonly"; both map to sandbox_mode = "read-only"',
+                },
+            ],
+        },
+    },
+    cursor: {
+        full: { fields: {}, warnings: [] },
+        readonly: {
+            fields: { readonly: true },
+            warnings: [],
+        },
+        none: {
+            fields: { readonly: true },
+            warnings: [
+                {
+                    agent: "cursor",
+                    feature: "toolAccess",
+                    message: 'Cursor does not distinguish "none" from "readonly"; both map to readonly: true',
+                },
+            ],
+        },
+    },
+    "gemini-cli": {
+        full: { fields: {}, warnings: [] },
+        readonly: {
+            fields: { tools: ["read_file", "list_dir", "grep_search", "web_search"] },
+            warnings: [],
+        },
+        none: {
+            fields: { tools: [] },
+            warnings: [],
+        },
+    },
+    opencode: {
+        full: { fields: {}, warnings: [] },
+        readonly: {
+            fields: { permission: { edit: "deny", bash: "deny" } },
+            warnings: [],
+        },
+        none: {
+            fields: { permission: { edit: "deny", bash: "deny", task: "deny" } },
+            warnings: [],
+        },
+    },
+    augment: {
+        full: { fields: {}, warnings: [] },
+        readonly: {
+            fields: {
+                disabled_tools: ["str-replace-editor", "save-file", "remove-files", "launch-process"],
+            },
+            warnings: [],
+        },
+        none: {
+            fields: { tools: [] },
+            warnings: [],
+        },
+    },
+    junie: {
+        full: { fields: {}, warnings: [] },
+        readonly: {
+            fields: { disallowedTools: ["Write", "Edit", "Bash"] },
+            warnings: [],
+        },
+        none: {
+            fields: { tools: [] },
+            warnings: [],
+        },
+    },
+    "kilo-code": {
+        full: { fields: {}, warnings: [] },
+        readonly: {
+            fields: { permission: { edit: "deny", bash: "deny" } },
+            warnings: [],
+        },
+        none: {
+            fields: { permission: { edit: "deny", bash: "deny", task: "deny" } },
+            warnings: [],
+        },
+    },
+    kiro: {
+        full: { fields: {}, warnings: [] },
+        readonly: {
+            fields: { tools: ["read", "web"] },
+            warnings: [],
+        },
+        none: {
+            fields: { tools: [] },
+            warnings: [],
+        },
+    },
+    "roo-code": {
+        full: {
+            fields: { groups: ["read", "edit", "command", "mcp"] },
+            warnings: [],
+        },
+        readonly: {
+            fields: { groups: ["read", "mcp"] },
+            warnings: [],
+        },
+        none: {
+            fields: { groups: ["read"] },
+            warnings: [],
+        },
+    },
+};
+/**
+ * Map a portable tool access level to agent-native fields.
+ *
+ * Returns fields to merge into the rendered output and any warnings
+ * for lossy mappings.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const mapToolAccess = (toolAccess, agentId) => {
+    const level = toolAccess ?? "full";
+    const agentTable = TOOL_ACCESS_TABLE[agentId];
+    if (agentTable === undefined) {
+        // Unknown agent — default to no fields
+        return { fields: {}, warnings: [] };
+    }
+    return agentTable[level];
+};
+//# sourceMappingURL=tool-access-mapping.js.map

package/dist/src/unstable/subagents/rendering/tool-access-mapping.js.map

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

package/dist/src/unstable/subagents/rendering/types.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Shared types for subagent renderers.
+ *
+ * These types define the inputs and outputs for all subagent renderer functions.
+ * They are plain interfaces so that renderers remain pure functions.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import type { LossyRenderingWarning } from "../../commands/rendering-warnings.js";
+import type { RenderedFilePath } from "../../extensions/rendered-files.js";
+import type { ToolAccessLevel } from "../tool-access.js";
+/**
+ * Agent-specific overrides from SUBAGENT.md frontmatter `overrides` field.
+ * A record of string keys to unknown values that the renderer merges on top
+ * of portable fields.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type AgentOverrides = Readonly<Record<string, unknown>>;
+/**
+ * Renderer input — everything a subagent renderer needs to produce output.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface SubagentRenderInput {
+    /** The agent ID to render for. */
+    readonly agentId: string;
+    /** Subagent name (used for filenames and identifiers). */
+    readonly name: string;
+    /** Human-readable description (used for auto-delegation hints). */
+    readonly description: string;
+    /** Portable model tier or concrete model ID. */
+    readonly model: string | undefined;
+    /** Portable tool access level. */
+    readonly toolAccess: ToolAccessLevel | undefined;
+    /** Whether the subagent runs in background mode. */
+    readonly background: boolean | undefined;
+    /** SUBAGENT.md body text (after frontmatter). */
+    readonly body: string;
+    /** Agent-specific overrides from SUBAGENT.md frontmatter `overrides` field. */
+    readonly agentOverrides: AgentOverrides | undefined;
+}
+/**
+ * Renderer output — one rendered file.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface SubagentRenderOutput {
+    /** The rendered file content. */
+    readonly content: string;
+    /** The relative path for the rendered file (e.g., ".claude/agents/my-agent.md"). */
+    readonly path: RenderedFilePath;
+}
+/**
+ * Tagged union for render outcomes.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type SubagentRenderOutcome = SubagentRendered | SubagentSkipped;
+/**
+ * Successful render with optional lossy warnings.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface SubagentRendered {
+    readonly _tag: "Rendered";
+    /** Rendered file(s) — usually one, but Kiro produces two. */
+    readonly outputs: ReadonlyArray<SubagentRenderOutput>;
+    /** Lossy rendering warnings for unsupported features. */
+    readonly warnings: ReadonlyArray<LossyRenderingWarning>;
+}
+/**
+ * Skipped render with a reason.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface SubagentSkipped {
+    readonly _tag: "Skipped";
+    /** Why the render was skipped (e.g., "agent not in agents list"). */
+    readonly reason: string;
+}
+/**
+ * Construct a Rendered outcome.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const rendered: (outputs: ReadonlyArray<SubagentRenderOutput>, warnings?: ReadonlyArray<LossyRenderingWarning>) => SubagentRendered;
+/**
+ * Construct a Skipped outcome.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const skipped: (reason: string) => SubagentSkipped;
+/**
+ * Subagent renderer function signature shared by all format families.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type SubagentRenderer = (input: SubagentRenderInput) => SubagentRenderOutcome;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/unstable/subagents/rendering/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/subagents/rendering/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE/D;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,kCAAkC;IAClC,QAAQ,CAAC,UAAU,EAAE,eAAe,GAAG,SAAS,CAAC;IACjD,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,cAAc,EAAE,cAAc,GAAG,SAAS,CAAC;CACrD;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAEvE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;IACtD,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;CACzD;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GACnB,SAAS,aAAa,CAAC,oBAAoB,CAAC,EAC5C,WAAU,aAAa,CAAC,qBAAqB,CAAM,KAClD,gBAID,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,OAAO,GAAI,QAAQ,MAAM,KAAG,eAGvC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,mBAAmB,KAAK,qBAAqB,CAAC"}

package/dist/src/unstable/subagents/rendering/types.js

@@ -0,0 +1,28 @@
+/**
+ * Shared types for subagent renderers.
+ *
+ * These types define the inputs and outputs for all subagent renderer functions.
+ * They are plain interfaces so that renderers remain pure functions.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+/**
+ * Construct a Rendered outcome.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const rendered = (outputs, warnings = []) => ({
+    _tag: "Rendered",
+    outputs,
+    warnings,
+});
+/**
+ * Construct a Skipped outcome.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const skipped = (reason) => ({
+    _tag: "Skipped",
+    reason,
+});
+//# sourceMappingURL=types.js.map

package/dist/src/unstable/subagents/rendering/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/unstable/subagents/rendering/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkFH;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,OAA4C,EAC5C,WAAiD,EAAE,EACjC,EAAE,CAAC,CAAC;IACtB,IAAI,EAAE,UAAU;IAChB,OAAO;IACP,QAAQ;CACT,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAc,EAAmB,EAAE,CAAC,CAAC;IAC3D,IAAI,EAAE,SAAS;IACf,MAAM;CACP,CAAC,CAAC"}

package/dist/src/unstable/subagents/subagent-content.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Subagent content file module for SUBAGENT.md parsing and frontmatter schemas.
+ *
+ * Defines the frontmatter schema for SUBAGENT.md files, a parser that
+ * combines the shared frontmatter utility with subagent-specific validation,
+ * and a transformation for syncing frontmatter fields to manifest fields.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import { type AppError } from "../app-error/index.js";
+/**
+ * Schema for SUBAGENT.md frontmatter fields.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const SubagentFrontmatterSchema: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly description: Schema.String;
+    readonly model: Schema.optional<Schema.String>;
+    readonly toolAccess: Schema.optional<Schema.Literals<readonly ["full", "readonly", "none"]>>;
+    readonly background: Schema.optional<Schema.Boolean>;
+    readonly overrides: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+}>;
+/**
+ * Inferred type for SubagentFrontmatter schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type SubagentFrontmatter = Schema.Schema.Type<typeof SubagentFrontmatterSchema>;
+/**
+ * Result of parsing a SUBAGENT.md file.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface SubagentContentResult {
+    /** Parsed and validated frontmatter, or Option.none() if no frontmatter block was found. */
+    readonly frontmatter: Option.Option<SubagentFrontmatter>;
+    /** Content body after the frontmatter block, or full content if no frontmatter. */
+    readonly body: string;
+}
+/**
+ * Parse a SUBAGENT.md file's content into validated frontmatter and body.
+ *
+ * Delegates to the shared frontmatter parser, then validates the
+ * frontmatter against `SubagentFrontmatterSchema`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const parseSubagentMd: (content: string) => Effect.Effect<SubagentContentResult, AppError>;
+/**
+ * Schema for manifest fields projected from frontmatter.
+ *
+ * Used during publish to sync description, model, toolAccess, and background
+ * from SUBAGENT.md frontmatter into the subagent manifest.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const ManifestFieldsFromFrontmatterSchema: Schema.Struct<{
+    readonly description: Schema.optional<Schema.String>;
+    readonly model: Schema.optional<Schema.String>;
+    readonly toolAccess: Schema.optional<Schema.Literals<readonly ["full", "readonly", "none"]>>;
+    readonly background: Schema.optional<Schema.Boolean>;
+}>;
+/**
+ * Inferred type for ManifestFieldsFromFrontmatter.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type ManifestFieldsFromFrontmatter = Schema.Schema.Type<typeof ManifestFieldsFromFrontmatterSchema>;
+/**
+ * Project frontmatter fields to manifest fields.
+ *
+ * Extracts `description`, `model`, `toolAccess`, and `background` from a
+ * parsed `SubagentFrontmatter` for use in manifest updates.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const projectFrontmatterToManifest: (frontmatter: SubagentFrontmatter) => ManifestFieldsFromFrontmatter;
+//# sourceMappingURL=subagent-content.d.ts.map

package/dist/src/unstable/subagents/subagent-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-content.d.ts","sourceRoot":"","sources":["../../../../src/unstable/subagents/subagent-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGpE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;;;;;;EAWpC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEvF;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,4FAA4F;IAC5F,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACzD,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,QAAQ,CAqB3F,CAAC;AAEL;;;;;;;GAOG;AACH,eAAO,MAAM,mCAAmC;;;;;EAS9C,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,6BAA6B,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAC5D,OAAO,mCAAmC,CAC3C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,GACvC,aAAa,mBAAmB,KAC/B,6BAKD,CAAC"}

package/dist/src/unstable/subagents/subagent-content.js

@@ -0,0 +1,90 @@
+/**
+ * Subagent content file module for SUBAGENT.md parsing and frontmatter schemas.
+ *
+ * Defines the frontmatter schema for SUBAGENT.md files, a parser that
+ * combines the shared frontmatter utility with subagent-specific validation,
+ * and a transformation for syncing frontmatter fields to manifest fields.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import { parseFrontmatterEffect } from "../extensions/frontmatter.js";
+import { makeAppError } from "../app-error/index.js";
+import { ToolAccessLevelSchema } from "./tool-access.js";
+/**
+ * Schema for SUBAGENT.md frontmatter fields.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SubagentFrontmatterSchema = Schema.Struct({
+    name: Schema.String,
+    description: Schema.String,
+    model: Schema.optional(Schema.String),
+    toolAccess: Schema.optional(ToolAccessLevelSchema),
+    background: Schema.optional(Schema.Boolean),
+    overrides: Schema.optional(Schema.Record(Schema.String, Schema.Unknown)),
+}).annotate({
+    identifier: "SubagentFrontmatter",
+    title: "Subagent Frontmatter",
+    description: "YAML frontmatter fields for SUBAGENT.md files.",
+});
+/**
+ * Parse a SUBAGENT.md file's content into validated frontmatter and body.
+ *
+ * Delegates to the shared frontmatter parser, then validates the
+ * frontmatter against `SubagentFrontmatterSchema`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const parseSubagentMd = (content) => Effect.gen(function* () {
+    const parsed = yield* parseFrontmatterEffect(content);
+    if (parsed.frontmatter === undefined) {
+        return { frontmatter: Option.none(), body: parsed.body };
+    }
+    const frontmatter = yield* Effect.try({
+        try: () => Schema.decodeUnknownSync(SubagentFrontmatterSchema)(parsed.frontmatter),
+        catch: (error) => makeAppError({
+            code: "SUBAGENT_FRONTMATTER_INVALID",
+            what: "Invalid SUBAGENT.md frontmatter",
+            details: [error instanceof Error ? error.message : String(error)],
+            howToFix: "Check the frontmatter fields in your SUBAGENT.md file.",
+            cause: error,
+        }),
+    });
+    return { frontmatter: Option.some(frontmatter), body: parsed.body };
+});
+/**
+ * Schema for manifest fields projected from frontmatter.
+ *
+ * Used during publish to sync description, model, toolAccess, and background
+ * from SUBAGENT.md frontmatter into the subagent manifest.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const ManifestFieldsFromFrontmatterSchema = Schema.Struct({
+    description: Schema.optional(Schema.String),
+    model: Schema.optional(Schema.String),
+    toolAccess: Schema.optional(ToolAccessLevelSchema),
+    background: Schema.optional(Schema.Boolean),
+}).annotate({
+    identifier: "SubagentManifestFieldsFromFrontmatter",
+    title: "Subagent Manifest Fields from Frontmatter",
+    description: "Fields projected from SUBAGENT.md frontmatter to subagent manifest.",
+});
+/**
+ * Project frontmatter fields to manifest fields.
+ *
+ * Extracts `description`, `model`, `toolAccess`, and `background` from a
+ * parsed `SubagentFrontmatter` for use in manifest updates.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const projectFrontmatterToManifest = (frontmatter) => ({
+    description: frontmatter.description,
+    model: frontmatter.model,
+    toolAccess: frontmatter.toolAccess,
+    background: frontmatter.background,
+});
+//# sourceMappingURL=subagent-content.js.map

package/dist/src/unstable/subagents/subagent-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-content.js","sourceRoot":"","sources":["../../../../src/unstable/subagents/subagent-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAA0B,MAAM,8BAA8B,CAAC;AAC9F,OAAO,EAAE,YAAY,EAAiB,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,MAAM,CAAC;IACrD,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM;IAC1B,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAClD,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;CACzE,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,qBAAqB;IACjC,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EAAE,gDAAgD;CAC9D,CAAC,CAAC;AAqBH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAe,EAAkD,EAAE,CACjG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,MAAM,GAAsB,KAAK,CAAC,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAEzE,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAC3D,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QACpC,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,yBAAyB,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;QAClF,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,YAAY,CAAC;YACX,IAAI,EAAE,8BAA8B;YACpC,IAAI,EAAE,iCAAiC;YACvC,OAAO,EAAE,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjE,QAAQ,EAAE,wDAAwD;YAClE,KAAK,EAAE,KAAK;SACb,CAAC;KACL,CAAC,CAAC;IAEH,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AACtE,CAAC,CAAC,CAAC;AAEL;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/D,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAC3C,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAClD,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;CAC5C,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,uCAAuC;IACnD,KAAK,EAAE,2CAA2C;IAClD,WAAW,EAAE,qEAAqE;CACnF,CAAC,CAAC;AAWH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,WAAgC,EACD,EAAE,CAAC,CAAC;IACnC,WAAW,EAAE,WAAW,CAAC,WAAW;IACpC,KAAK,EAAE,WAAW,CAAC,KAAK;IACxB,UAAU,EAAE,WAAW,CAAC,UAAU;IAClC,UAAU,EAAE,WAAW,CAAC,UAAU;CACnC,CAAC,CAAC"}

package/dist/src/unstable/subagents/tool-access.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Portable tool access levels for subagents.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+export declare const TOOL_ACCESS_LEVELS: readonly ["full", "readonly", "none"];
+export type ToolAccessLevel = (typeof TOOL_ACCESS_LEVELS)[number];
+export declare const isToolAccessLevel: (value: string | undefined) => value is ToolAccessLevel;
+export declare const ToolAccessLevelSchema: Schema.Literals<readonly ["full", "readonly", "none"]>;
+//# sourceMappingURL=tool-access.d.ts.map

package/dist/src/unstable/subagents/tool-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-access.d.ts","sourceRoot":"","sources":["../../../../src/unstable/subagents/tool-access.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,eAAO,MAAM,kBAAkB,uCAAwC,CAAC;AAExE,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAIlE,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,GAAG,SAAS,KAAG,KAAK,IAAI,eACjB,CAAC;AAEvD,eAAO,MAAM,qBAAqB,wDAIhC,CAAC"}

package/dist/src/unstable/subagents/tool-access.js

@@ -0,0 +1,15 @@
+/**
+ * Portable tool access levels for subagents.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+export const TOOL_ACCESS_LEVELS = ["full", "readonly", "none"];
+const toolAccessLevelSet = new Set(TOOL_ACCESS_LEVELS);
+export const isToolAccessLevel = (value) => value !== undefined && toolAccessLevelSet.has(value);
+export const ToolAccessLevelSchema = Schema.Literals(TOOL_ACCESS_LEVELS).annotate({
+    identifier: "ToolAccessLevel",
+    title: "Tool Access Level",
+    description: "Portable subagent tool access level.",
+});
+//# sourceMappingURL=tool-access.js.map

package/dist/src/unstable/subagents/tool-access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-access.js","sourceRoot":"","sources":["../../../../src/unstable/subagents/tool-access.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAU,CAAC;AAIxE,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAS,kBAAkB,CAAC,CAAC;AAE/D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAyB,EAA4B,EAAE,CACvF,KAAK,KAAK,SAAS,IAAI,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAEvD,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC;IAChF,UAAU,EAAE,iBAAiB;IAC7B,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EAAE,sCAAsC;CACpD,CAAC,CAAC"}