@vibe-agent-toolkit/cli 0.2.0-rc.4 → 0.2.0-rc.6

package/dist/commands/claude/claude-config.js

@@ -15,6 +15,12 @@ export async function loadClaudeProjectConfig() {
     if (!configPath) {
         throw new Error('No vibe-agent-toolkit.config.yaml found. Run from a project directory.');
     }
+    // No `onUnknownKeys` argument: `parseConfigFile` already DEFAULTS to writing
+    // the warning to stderr, which is exactly what this lane needs — unknown keys
+    // are a warning rather than a refusal, and stderr keeps the YAML document on
+    // stdout machine-readable. Passing a callback byte-identical to the default
+    // said "this command has an opinion here" while changing nothing, so a later
+    // reader would have to diff it against the default to learn it was dead.
     const config = await parseConfigFile(configPath);
     const configDir = dirname(configPath);
     return { configPath, configDir, claudeConfig: config.claude };

package/dist/commands/claude/claude-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"claude-config.js","sourceRoot":"","sources":["../../../src/commands/claude/claude-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAqB,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAQ3D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAK3C,+EAA+E;IAC/E,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACjD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEtC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;AAChE,CAAC"}
+{"version":3,"file":"claude-config.js","sourceRoot":"","sources":["../../../src/commands/claude/claude-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAqB,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAQ3D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAK3C,+EAA+E;IAC/E,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACjD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAC5F,CAAC;IAED,6EAA6E;IAC7E,8EAA8E;IAC9E,6EAA6E;IAC7E,4EAA4E;IAC5E,6EAA6E;IAC7E,yEAAyE;IACzE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEtC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;AAChE,CAAC"}

package/dist/commands/claude/org/helpers.d.ts

@@ -59,10 +59,68 @@ export declare function autopaginateCustom(fetchPage: (cursor: string | undefine
  * Reduces duplication of --limit, --after-id, --debug across list subcommands.
  */
 export declare function addPaginationOptions(cmd: Command): Command;
+/**
+ * The exit code for a run that COMPLETED and reported failures.
+ *
+ * Read against the contract every command's `--help` publishes — `0` no
+ * error-severity findings, `1` at least one, `2` a system error — this is `1`:
+ * the command ran, produced its document, and that document reports something
+ * that went wrong. `2` stays for the run that could not happen at all (no
+ * credential, no such source), which is what {@link handleCommandError} ends on.
+ *
+ * 🔑 It exists because a batch command has an ending the old code could not
+ * express. `skills install --from-npm` catches each per-skill upload failure and
+ * returns normally, so a run in which all three skills were rejected wrote
+ * `status: success` beside `skillsFailed: 3` and exited 0 — and a CI wrapper
+ * spelled `vat claude org skills install --from-npm … || fail` published nothing
+ * and reported green.
+ */
+export declare const ORG_RUN_FAILED_EXIT_CODE = 1;
+/**
+ * An org command's document, tagged as one that must NOT end in a success exit.
+ *
+ * A batch command's failures are part of its REPORT, not an exception: the
+ * document has to be published (which skills landed, which did not, and why),
+ * and the run still has to end non-zero. Throwing would end non-zero but discard
+ * the report; returning plainly publishes the report but claims success. This
+ * wrapper is the third option, and it keeps the "did this fail?" decision in one
+ * place instead of letting each command invent a status field.
+ */
+export interface OrgCommandFailure {
+    readonly orgCommandFailed: true;
+    readonly document: object;
+}
+/** Tag `document` as the report of a run that failed. */
+export declare function orgCommandFailure(document: object): OrgCommandFailure;
+/** What an org command writes to stdout, and the code it ends on. */
+export interface OrgCommandEnding {
+    readonly document: Record<string, unknown>;
+    readonly exitCode: number;
+}
+/**
+ * Pure: the document and exit code an org command's result ends on.
+ *
+ * Split out of {@link executeOrgCommand} because it is the whole of the
+ * status/exit-code decision and the only part of it that is testable without
+ * spawning a process — `executeOrgCommand` itself ends in `process.exit`.
+ */
+export declare function buildOrgCommandEnding(result: object, durationMs: number): OrgCommandEnding;
 /**
  * Execute an org command with standard error handling.
  * Sets up client, logger, timer, and catches errors uniformly.
+ *
+ * An action may return its document plainly (success, exit 0) or wrapped in
+ * {@link orgCommandFailure} (the document is still published, the run exits
+ * {@link ORG_RUN_FAILED_EXIT_CODE}). Anything thrown is the system error and
+ * ends on {@link handleCommandError}'s exit 2.
+ *
+ * 🔑 Usage guards belong INSIDE the action, not in the Commander action that
+ * calls this. `bin.ts` runs the synchronous `program.parse()`, so a throw from
+ * an async action handler is a floating rejection that reaches no catch: Node
+ * prints a raw stack trace carrying absolute `$HOME` paths, writes nothing to
+ * stdout, and exits 1 — which this CLI's contract reads as "at least one
+ * error-severity finding" for a run in which nothing executed.
  */
-export declare function executeOrgCommand<T extends object>(commandName: string, debug: boolean | undefined, action: (ctx: OrgCommandContext) => Promise<T>): Promise<void>;
+export declare function executeOrgCommand(commandName: string, debug: boolean | undefined, action: (ctx: OrgCommandContext) => Promise<object>): Promise<void>;
 export {};
 //# sourceMappingURL=helpers.d.ts.map

package/dist/commands/claude/org/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/commands/claude/org/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAE3E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAIvD,UAAU,iBAAiB;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;AAEtE,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAInD;AAED,8DAA8D;AAC9D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED,kDAAkD;AAClD,wBAAgB,mBAAmB,IAAI,MAAM,CAI5C;AAED,UAAU,oBAAoB;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,oBAAoB,EAC7B,KAAK,CAAC,EAAE,WAAW,GAClB,WAAW,CAMb;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAiCD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,WAAW,GACtB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,CA0B7C;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,CAI7C;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,UAAU,CAAC,GAC7D,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,CAE7C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAK1D;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EACtD,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,OAAO,GAAG,SAAS,EAC1B,MAAM,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAgBf"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/commands/claude/org/helpers.ts"],"names":[],"mappings":"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"}

package/dist/commands/claude/org/helpers.js

@@ -98,9 +98,64 @@ export function addPaginationOptions(cmd) {
         .option('--after-id <id>', 'Cursor for pagination')
         .option('--debug', 'Enable debug logging');
 }
+/**
+ * The exit code for a run that COMPLETED and reported failures.
+ *
+ * Read against the contract every command's `--help` publishes — `0` no
+ * error-severity findings, `1` at least one, `2` a system error — this is `1`:
+ * the command ran, produced its document, and that document reports something
+ * that went wrong. `2` stays for the run that could not happen at all (no
+ * credential, no such source), which is what {@link handleCommandError} ends on.
+ *
+ * 🔑 It exists because a batch command has an ending the old code could not
+ * express. `skills install --from-npm` catches each per-skill upload failure and
+ * returns normally, so a run in which all three skills were rejected wrote
+ * `status: success` beside `skillsFailed: 3` and exited 0 — and a CI wrapper
+ * spelled `vat claude org skills install --from-npm … || fail` published nothing
+ * and reported green.
+ */
+export const ORG_RUN_FAILED_EXIT_CODE = 1;
+/** Tag `document` as the report of a run that failed. */
+export function orgCommandFailure(document) {
+    return { orgCommandFailed: true, document };
+}
+function isOrgCommandFailure(result) {
+    return result.orgCommandFailed === true;
+}
+/**
+ * Pure: the document and exit code an org command's result ends on.
+ *
+ * Split out of {@link executeOrgCommand} because it is the whole of the
+ * status/exit-code decision and the only part of it that is testable without
+ * spawning a process — `executeOrgCommand` itself ends in `process.exit`.
+ */
+export function buildOrgCommandEnding(result, durationMs) {
+    const failed = isOrgCommandFailure(result);
+    const payload = (failed ? result.document : result);
+    return {
+        document: {
+            status: failed ? 'error' : 'success',
+            ...payload,
+            duration: `${String(durationMs)}ms`,
+        },
+        exitCode: failed ? ORG_RUN_FAILED_EXIT_CODE : 0,
+    };
+}
 /**
  * Execute an org command with standard error handling.
  * Sets up client, logger, timer, and catches errors uniformly.
+ *
+ * An action may return its document plainly (success, exit 0) or wrapped in
+ * {@link orgCommandFailure} (the document is still published, the run exits
+ * {@link ORG_RUN_FAILED_EXIT_CODE}). Anything thrown is the system error and
+ * ends on {@link handleCommandError}'s exit 2.
+ *
+ * 🔑 Usage guards belong INSIDE the action, not in the Commander action that
+ * calls this. `bin.ts` runs the synchronous `program.parse()`, so a throw from
+ * an async action handler is a floating rejection that reaches no catch: Node
+ * prints a raw stack trace carrying absolute `$HOME` paths, writes nothing to
+ * stdout, and exits 1 — which this CLI's contract reads as "at least one
+ * error-severity finding" for a run in which nothing executed.
  */
 export async function executeOrgCommand(commandName, debug, action) {
     const logger = createLogger(debug ? { debug: true } : {});
@@ -108,13 +163,9 @@ export async function executeOrgCommand(commandName, debug, action) {
     try {
         const client = createOrgApiClientFromEnv();
         const ctx = { client, logger, startTime };
-        const result = await action(ctx);
-        writeYamlOutput({
-            status: 'success',
-            ...result,
-            duration: `${String(Date.now() - startTime)}ms`,
-        });
-        process.exit(0);
+        const ending = buildOrgCommandEnding(await action(ctx), Date.now() - startTime);
+        writeYamlOutput(ending.document);
+        process.exit(ending.exitCode);
     }
     catch (error) {
         handleCommandError(error, logger, startTime, commandName);

package/dist/commands/claude/org/helpers.js.map

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

package/dist/commands/claude/org/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/claude/org/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,wBAAgB,gBAAgB,IAAI,OAAO,CA8C1C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/claude/org/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,wBAAgB,gBAAgB,IAAI,OAAO,CAsD1C"}

package/dist/commands/claude/org/index.js

@@ -18,29 +18,37 @@ import { createOrgWorkspacesCommand } from './workspaces.js';
 export function createOrgCommand() {
     const command = new Command('org');
     command
-        .description('Manage your Anthropic organization (Admin API)')
+        .description('Manage your Anthropic organization (Admin API) and workspace skills (Skills API)')
         .helpCommand(false)
         .addHelpText('after', `
 Description:
-  Organization administration via the Anthropic Admin API.
-  Requires ANTHROPIC_ADMIN_API_KEY environment variable.
-  Skills commands also require ANTHROPIC_API_KEY.
+  Two surfaces under one group: organization administration via the Anthropic
+  Admin API, and workspace skills via the Skills API.
 
-Commands:
-  info              Show organization details
-  users             Manage users (list, get, update, remove)
-  invites           Manage invites (list, create, delete)
-  workspaces        Manage workspaces and members
-  api-keys          Manage API keys (list, update)
-  usage             Fetch daily token usage report
-  cost              Fetch USD cost report
-  code-analytics    Fetch Claude Code metrics
-  skills            Manage organization skills
+  Each takes its OWN key, and never the other one. Set the key for the commands
+  you are running; neither family needs both.
+
+Commands and the key each requires:
+  ANTHROPIC_ADMIN_API_KEY (sk-ant-admin-...)
+    info              Show organization details
+    users             Manage users (list, get, update, remove)
+    invites           Manage invites (list, create, delete)
+    workspaces        Manage workspaces and members
+    api-keys          Manage API keys (list, update)
+    usage             Fetch daily token usage report
+    cost              Fetch USD cost report
+    code-analytics    Fetch Claude Code metrics
+
+  ANTHROPIC_API_KEY (a regular workspace key, sk-ant-api03-...)
+    skills            Manage workspace skills — upload, list, version, delete.
+                      The admin key is never sent to these endpoints and is not
+                      needed to run them.
 
 Exit Codes:
   0 - Success
-  1 - Not-yet-implemented (stub commands)
-  2 - System error (missing key, API failure)
+  1 - The run happened and the outcome was not clean (e.g. skills install
+      --from-npm uploaded some skills and failed others), or a stub command
+  2 - The run could not happen: missing key, API failure, unusable input
 
 Example:
   $ export ANTHROPIC_ADMIN_API_KEY=sk-ant-admin-...

package/dist/commands/claude/org/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/claude/org/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAE7D,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;IAEnC,OAAO;SACJ,WAAW,CAAC,gDAAgD,CAAC;SAC7D,WAAW,CAAC,KAAK,CAAC;SAClB,WAAW,CAAC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BzB,CAAC,CAAC;IAED,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,UAAU,CAAC,0BAA0B,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,6BAA6B,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAE7C,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/claude/org/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAE7D,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;IAEnC,OAAO;SACJ,WAAW,CAAC,kFAAkF,CAAC;SAC/F,WAAW,CAAC,KAAK,CAAC;SAClB,WAAW,CAAC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCzB,CAAC,CAAC;IAED,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,UAAU,CAAC,0BAA0B,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,6BAA6B,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAE7C,OAAO,OAAO,CAAC;AACjB,CAAC"}