@agentxm/extension-authoring 0.28.11 → 0.28.13

package/dist/src/hooks/new-hook.js

@@ -1,164 +0,0 @@
-/**
- * New hook operation — scaffolds a new hook directory with the manifest and a
- * starter entrypoint.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import * as FileSystem from "effect/FileSystem";
-import * as Path from "effect/Path";
-import * as Effect from "effect/Effect";
-import { AuthoringFailed } from "../errors.js";
-import { AuthoringFailureAdapter, withAdaptedStepFailures } from "../failure-adapter.js";
-import { createCanonicalDirectory, recoverCanonicalDirectory } from "@agentxm/extension-workspace";
-import { preflightCreateOnly } from "../create-preflight.js";
-import { decodeExtensionNameSync } from "@agentxm/extension-model/unstable/extensions";
-import { WorkspaceMutations } from "@agentxm/workspace-state";
-import { decodeVersionSync } from "@agentxm/extension-model/unstable/version-constraints";
-import { HOOK_EXTENSION_DIR, HOOK_MANIFEST_FILENAME, HOOK_MANIFEST_SCHEMA_URL, } from "@agentxm/extension-model/unstable/hooks/manifest-schema";
-// -----------------------------------------------------------------------------
-// Helpers
-// -----------------------------------------------------------------------------
-const INITIAL_HOOK_VERSION = decodeVersionSync("0.1.0");
-const entrypointFilename = (runtime) => {
-    switch (runtime) {
-        case "bash":
-            return "hook.sh";
-        case "node":
-            return "hook.js";
-        case "python":
-            return "hook.py";
-    }
-};
-const matcherForBinding = (event, matcher) => event === "tool.pre" || event === "tool.post" ? matcher : undefined;
-const makeEntrypoint = (runtime, fqn) => {
-    switch (runtime) {
-        case "bash":
-            return `#!/usr/bin/env bash
-# ${fqn}
-# Receives the agent hook event payload as JSON on stdin.
-set -euo pipefail
-
-payload="$(cat)"
-
-# TODO: inspect "$payload" and implement the hook.
-# Emit JSON on stdout or exit non-zero to influence the agent.
-exit 0
-`;
-        case "node":
-            return `#!/usr/bin/env node
-// ${fqn}
-// Receives the agent hook event payload as JSON on stdin.
-let raw = "";
-process.stdin.on("data", (chunk) => {
-  raw += chunk;
-});
-process.stdin.on("end", () => {
-  const payload = raw ? JSON.parse(raw) : {};
-
-  // TODO: inspect payload and implement the hook.
-  // Emit JSON on stdout or exit non-zero to influence the agent.
-  process.exit(0);
-});
-`;
-        case "python":
-            return `#!/usr/bin/env python3
-"""${fqn}
-
-Receives the agent hook event payload as JSON on stdin.
-"""
-import json
-import sys
-
-raw = sys.stdin.read()
-payload = json.loads(raw) if raw else {}
-
-# TODO: inspect payload and implement the hook.
-# Emit JSON on stdout or exit non-zero to influence the agent.
-sys.exit(0)
-`;
-    }
-};
-// -----------------------------------------------------------------------------
-// Public API
-// -----------------------------------------------------------------------------
-/**
- * New-hook operation handler.
- *
- * 1. Compute managed extension directory path
- * 2. Check if the hook already exists (directory or settings entry)
- * 3. Create the managed extension + src directories
- * 4. Write hook.json manifest
- * 5. Write starter entrypoint in src/
- */
-export const newHook = (op) => Effect.gen(function* () {
-    const fs = yield* FileSystem.FileSystem;
-    const path = yield* Path.Path;
-    const ws = yield* WorkspaceMutations;
-    const base = ws.baseDir;
-    if (ws.layout.scope !== "project") {
-        return yield* new AuthoringFailed({
-            category: "validation",
-            detail: "New hooks can only be scaffolded in a project workspace",
-        });
-    }
-    const { name, owner, runtime, event, matcher } = op.args;
-    const fqn = `${owner}/${HOOK_EXTENSION_DIR}/${name}`;
-    const configuredHooks = yield* ws.getConfiguredHookEntries();
-    const canonicalPath = path.join(ws.layout.authoredRoot("hook"), name);
-    yield* recoverCanonicalDirectory({ baseDir: base, canonicalPath });
-    yield* preflightCreateOnly({
-        subject: "Hook",
-        name,
-        configured: Object.hasOwn(configuredHooks, name),
-        destinations: [canonicalPath],
-    });
-    const entrypointFile = entrypointFilename(runtime);
-    const bindingMatcher = matcherForBinding(event, matcher);
-    const manifest = {
-        $schema: HOOK_MANIFEST_SCHEMA_URL,
-        owner,
-        type: "hook",
-        name: decodeExtensionNameSync(name),
-        version: INITIAL_HOOK_VERSION,
-        runtime,
-        entrypoint: `src/${entrypointFile}`,
-        bindings: [
-            bindingMatcher === undefined ? { on: event } : { on: event, matcherRaw: bindingMatcher },
-        ],
-    };
-    yield* createCanonicalDirectory({
-        baseDir: base,
-        canonicalPath,
-        subject: "Hook",
-        requiredFiles: [HOOK_MANIFEST_FILENAME, `src/${entrypointFile}`],
-        populate: (stagingPath) => {
-            const srcDir = path.join(stagingPath, "src");
-            return Effect.gen(function* () {
-                yield* fs.makeDirectory(srcDir, { recursive: true }).pipe(Effect.mapError((e) => new AuthoringFailed({
-                    category: "validation",
-                    detail: `Failed to create hook directory: ${srcDir}`,
-                    cause: e,
-                })));
-                yield* fs
-                    .writeFileString(path.join(stagingPath, HOOK_MANIFEST_FILENAME), JSON.stringify(manifest, null, 2) + "\n")
-                    .pipe(Effect.mapError((e) => new AuthoringFailed({
-                    category: "validation",
-                    detail: "Hook manifest could not be written",
-                    cause: e,
-                })));
-                yield* fs
-                    .writeFileString(path.join(srcDir, entrypointFile), makeEntrypoint(runtime, fqn))
-                    .pipe(Effect.mapError((e) => new AuthoringFailed({
-                    category: "validation",
-                    detail: `Failed to write ${entrypointFile}`,
-                    cause: e,
-                })));
-            });
-        },
-    });
-    return {
-        result: "success",
-        message: `Created hook ${fqn}`,
-    };
-}).pipe(withAdaptedStepFailures);
-//# sourceMappingURL=new-hook.js.map

package/dist/src/packs/new-pack.d.ts

@@ -1,37 +0,0 @@
-/**
- * New pack operation — scaffolds a new pack directory with manifest.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import * as FileSystem from "effect/FileSystem";
-import * as Path from "effect/Path";
-import { AuthoringFailureAdapter } from "../failure-adapter.js";
-import type { Handle } from "@agentxm/extension-model/unstable/extensions/handle";
-import type { OperationHandler } from "@agentxm/workspace-operations";
-import type { Operation } from "@agentxm/workspace-operations";
-import { WorkspaceMutations } from "@agentxm/workspace-state";
-/**
- * Args for the new pack operation.
- */
-export interface NewPackOperationArgs {
-    /** Pack name (without owner). */
-    readonly name: string;
-    /** Profile (e.g., "@myorg"). */
-    readonly owner: Handle;
-}
-/**
- * Scaffold a new pack in the workspace.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export type NewPackOperation = Operation<"new-pack", NewPackOperationArgs>;
-/**
- * New pack operation handler.
- *
- * 1. Compute pack directory path
- * 2. Check if pack manifest already exists
- * 3. Create pack directory
- * 4. Write pack.json manifest
- */
-export declare const newPack: OperationHandler<NewPackOperation, FileSystem.FileSystem | Path.Path | WorkspaceMutations | AuthoringFailureAdapter>;
-//# sourceMappingURL=new-pack.d.ts.map

package/dist/src/packs/new-pack.js

@@ -1,90 +0,0 @@
-/**
- * New pack operation — scaffolds a new pack directory with manifest.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import * as FileSystem from "effect/FileSystem";
-import * as Path from "effect/Path";
-import * as Effect from "effect/Effect";
-import { AuthoringFailed } from "../errors.js";
-import { AuthoringFailureAdapter, withAdaptedStepFailures } from "../failure-adapter.js";
-import { createCanonicalDirectory, recoverCanonicalDirectory } from "@agentxm/extension-workspace";
-import { preflightCreateOnly } from "../create-preflight.js";
-import { decodeExtensionNameSync, formatFqn } from "@agentxm/extension-model/unstable/extensions";
-import { PACK_MANIFEST_FILENAME, PACK_MANIFEST_SCHEMA_URL, } from "@agentxm/extension-model/unstable/packs/manifest-schema";
-import { WorkspaceMutations } from "@agentxm/workspace-state";
-import { decodeVersionSync } from "@agentxm/extension-model/unstable/version-constraints";
-// -----------------------------------------------------------------------------
-// Public API
-// -----------------------------------------------------------------------------
-/**
- * New pack operation handler.
- *
- * 1. Compute pack directory path
- * 2. Check if pack manifest already exists
- * 3. Create pack directory
- * 4. Write pack.json manifest
- */
-export const newPack = (op) => Effect.gen(function* () {
-    const fs = yield* FileSystem.FileSystem;
-    const path = yield* Path.Path;
-    const ws = yield* WorkspaceMutations;
-    const base = ws.baseDir;
-    if (ws.layout.scope !== "project") {
-        return yield* new AuthoringFailed({
-            category: "validation",
-            detail: "New packs can only be scaffolded in a project workspace",
-        });
-    }
-    const initialVersion = decodeVersionSync("0.0.1");
-    const { name, owner } = op.args;
-    const extensionName = decodeExtensionNameSync(name);
-    const fqn = formatFqn({ owner, type: "pack", name: extensionName });
-    // 1. Compute pack directory path
-    const canonicalPath = path.join(ws.layout.authoredRoot("pack"), name);
-    const configuredPacks = yield* ws.getConfiguredPackEntries();
-    yield* recoverCanonicalDirectory({
-        baseDir: base,
-        canonicalPath,
-    });
-    yield* preflightCreateOnly({
-        subject: "Pack",
-        name,
-        configured: Object.hasOwn(configuredPacks, name),
-        destinations: [canonicalPath],
-    });
-    const manifest = {
-        $schema: PACK_MANIFEST_SCHEMA_URL,
-        owner,
-        type: "pack",
-        name: extensionName,
-        version: initialVersion,
-        dependencies: {},
-    };
-    yield* createCanonicalDirectory({
-        baseDir: base,
-        canonicalPath,
-        subject: "Pack",
-        requiredFiles: [PACK_MANIFEST_FILENAME],
-        populate: (stagingPath) => {
-            const manifestPath = path.join(stagingPath, PACK_MANIFEST_FILENAME);
-            return Effect.gen(function* () {
-                yield* fs.makeDirectory(stagingPath, { recursive: true }).pipe(Effect.mapError((e) => new AuthoringFailed({
-                    category: "internal",
-                    detail: `Failed to create pack directory: ${stagingPath}`,
-                    cause: e,
-                })));
-                yield* fs.writeFileString(manifestPath, JSON.stringify(manifest, null, 2) + "\n").pipe(Effect.mapError((e) => new AuthoringFailed({
-                    category: "internal",
-                    detail: `Failed to write pack manifest: ${manifestPath}`,
-                    cause: e,
-                })));
-            });
-        },
-    });
-    return {
-        result: "success",
-        message: `Created pack ${fqn}`,
-    };
-}).pipe(withAdaptedStepFailures);
-//# sourceMappingURL=new-pack.js.map

package/dist/src/skills/new-skill.d.ts

@@ -1,38 +0,0 @@
-/**
- * New skill operation — scaffolds a new skill directory with manifest and SKILL.md.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import * as FileSystem from "effect/FileSystem";
-import * as Path from "effect/Path";
-import { AuthoringFailureAdapter } from "../failure-adapter.js";
-import type { Handle } from "@agentxm/extension-model/unstable/extensions/handle";
-import type { OperationHandler } from "@agentxm/workspace-operations";
-import type { Operation } from "@agentxm/workspace-operations";
-import { WorkspaceMutations } from "@agentxm/workspace-state";
-/**
- * Args for the new-skill operation.
- */
-export interface NewSkillOperationArgs {
-    /** Skill name (validated, lowercase with hyphens). */
-    readonly name: string;
-    /** Profile (e.g., "@myorg"). */
-    readonly owner: Handle;
-}
-/**
- * Scaffold a new skill in the workspace.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export type NewSkillOperation = Operation<"new-skill", NewSkillOperationArgs>;
-/**
- * New-skill operation handler.
- *
- * 1. Compute paths from the resolved workspace layout
- * 2. Check if skill already exists in settings
- * 3. Create skill directory (src/)
- * 4. Write skill.json manifest
- * 5. Write starter SKILL.md
- */
-export declare const newSkill: OperationHandler<NewSkillOperation, FileSystem.FileSystem | Path.Path | WorkspaceMutations | AuthoringFailureAdapter>;
-//# sourceMappingURL=new-skill.d.ts.map

package/dist/src/skills/new-skill.js

@@ -1,102 +0,0 @@
-/**
- * New skill operation — scaffolds a new skill directory with manifest and SKILL.md.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import * as FileSystem from "effect/FileSystem";
-import * as Path from "effect/Path";
-import * as Effect from "effect/Effect";
-import { AuthoringFailed } from "../errors.js";
-import { AuthoringFailureAdapter, withAdaptedStepFailures } from "../failure-adapter.js";
-import { createCanonicalDirectory, recoverCanonicalDirectory } from "@agentxm/extension-workspace";
-import { preflightCreateOnly } from "../create-preflight.js";
-import { decodeExtensionNameSync } from "@agentxm/extension-model/unstable/extensions";
-import { WorkspaceMutations } from "@agentxm/workspace-state";
-import { MANIFEST_FILENAME, MANIFEST_SCHEMA_URL, } from "@agentxm/extension-model/unstable/skills/manifest-schema";
-import { decodeVersionSync } from "@agentxm/extension-model/unstable/version-constraints";
-// -----------------------------------------------------------------------------
-// Helpers
-// -----------------------------------------------------------------------------
-const makeSkillMd = (name) => `---
-name: ${name}
-description: Describe when this skill should be triggered by the agent
----
-
-Describe what this skill does and when to use it.
-`;
-const INITIAL_SKILL_VERSION = decodeVersionSync("0.0.1");
-// -----------------------------------------------------------------------------
-// Public API
-// -----------------------------------------------------------------------------
-/**
- * New-skill operation handler.
- *
- * 1. Compute paths from the resolved workspace layout
- * 2. Check if skill already exists in settings
- * 3. Create skill directory (src/)
- * 4. Write skill.json manifest
- * 5. Write starter SKILL.md
- */
-export const newSkill = (op) => Effect.gen(function* () {
-    const fs = yield* FileSystem.FileSystem;
-    const path = yield* Path.Path;
-    const ws = yield* WorkspaceMutations;
-    const base = ws.baseDir;
-    if (ws.layout.scope !== "project") {
-        return yield* new AuthoringFailed({
-            category: "validation",
-            detail: "New skills can only be scaffolded in a project workspace",
-        });
-    }
-    const { name, owner } = op.args;
-    const fqn = `${owner}/skills/${name}`;
-    const configuredSkills = yield* ws.getConfiguredSkillEntries();
-    const canonicalPath = path.join(ws.layout.authoredRoot("skill"), name);
-    yield* recoverCanonicalDirectory({ baseDir: base, canonicalPath });
-    yield* preflightCreateOnly({
-        subject: "Skill",
-        name,
-        configured: Object.hasOwn(configuredSkills, name),
-        destinations: [canonicalPath],
-    });
-    const manifest = {
-        $schema: MANIFEST_SCHEMA_URL,
-        owner,
-        type: "skill",
-        name: decodeExtensionNameSync(name),
-        version: INITIAL_SKILL_VERSION,
-    };
-    yield* createCanonicalDirectory({
-        baseDir: base,
-        canonicalPath,
-        subject: "Skill",
-        requiredFiles: [MANIFEST_FILENAME, "src/SKILL.md"],
-        populate: (stagingPath) => {
-            const skillSrcPath = path.join(stagingPath, "src");
-            return Effect.gen(function* () {
-                yield* fs.makeDirectory(skillSrcPath, { recursive: true }).pipe(Effect.mapError((e) => new AuthoringFailed({
-                    category: "validation",
-                    detail: `Failed to create skill directory: ${skillSrcPath}`,
-                    cause: e,
-                })));
-                yield* fs
-                    .writeFileString(path.join(stagingPath, MANIFEST_FILENAME), JSON.stringify(manifest, null, 2) + "\n")
-                    .pipe(Effect.mapError((e) => new AuthoringFailed({
-                    category: "validation",
-                    detail: "Skill manifest could not be written",
-                    cause: e,
-                })));
-                yield* fs.writeFileString(path.join(skillSrcPath, "SKILL.md"), makeSkillMd(name)).pipe(Effect.mapError((e) => new AuthoringFailed({
-                    category: "validation",
-                    detail: "Failed to write SKILL.md",
-                    cause: e,
-                })));
-            });
-        },
-    });
-    return {
-        result: "success",
-        message: `Created skill ${fqn}`,
-    };
-}).pipe(withAdaptedStepFailures);
-//# sourceMappingURL=new-skill.js.map