@batonfx/skills 0.1.0 → 0.2.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 $ bun build ./src/index.ts --outdir dist --target bun --format esm
-Bundled 247 modules in 654ms
+Bundled 173 modules in 591ms
 
-  index.js  1.14 MB  (entry point)
+  index.js  1.15 MB  (entry point)
 

package/dist/index.js

@@ -8203,6 +8203,7 @@ function resolveAt(key) {
 }
 var resolveIdentifier = /* @__PURE__ */ resolveAt("identifier");
 var resolveTitle = /* @__PURE__ */ resolveAt("title");
+var resolveDescription = /* @__PURE__ */ resolveAt("description");
 var resolveBrands = /* @__PURE__ */ resolveAt("brands");
 var getExpected = /* @__PURE__ */ memoize((ast) => {
   const identifier2 = resolveIdentifier(ast);
@@ -11172,6 +11173,7 @@ function runChecks(checks, s) {
 var ClassTypeId = "~effect/Schema/Class";
 var STRUCTURAL_ANNOTATION_KEY = "~structural";
 var resolveIdentifier2 = resolveIdentifier;
+var resolveDescription2 = resolveDescription;
 function isJson(u) {
   const onPath = new Set;
   const validated = new Set;
@@ -34373,7 +34375,275 @@ var exports_skill_loader = {};
 __export(exports_skill_loader, {
   layer: () => layer2
 });
+// ../../node_modules/.bun/effect@4.0.0-beta.93/node_modules/effect/dist/unstable/ai/Tool.js
+var exports_Tool = {};
+__export(exports_Tool, {
+  unsafeSecureJsonParse: () => unsafeSecureJsonParse,
+  providerDefined: () => providerDefined,
+  make: () => make33,
+  isUserDefined: () => isUserDefined,
+  isProviderDefined: () => isProviderDefined,
+  isEmptyParamsRecord: () => isEmptyParamsRecord,
+  isDynamic: () => isDynamic,
+  getStrictMode: () => getStrictMode,
+  getJsonSchemaFromSchema: () => getJsonSchemaFromSchema,
+  getJsonSchema: () => getJsonSchema,
+  getDescription: () => getDescription,
+  dynamic: () => dynamic,
+  TypeId: () => TypeId37,
+  Title: () => Title,
+  Strict: () => Strict,
+  Readonly: () => Readonly,
+  ProviderDefinedTypeId: () => ProviderDefinedTypeId,
+  OpenWorld: () => OpenWorld,
+  NameMapper: () => NameMapper,
+  Meta: () => Meta,
+  Idempotent: () => Idempotent,
+  EmptyParams: () => EmptyParams,
+  DynamicTypeId: () => DynamicTypeId,
+  Destructive: () => Destructive
+});
+var TypeId37 = "~effect/ai/Tool";
+var ProviderDefinedTypeId = "~effect/ai/Tool/ProviderDefined";
+var DynamicTypeId = "~effect/ai/Tool/Dynamic";
+var isUserDefined = (u) => hasProperty(u, TypeId37) && !isProviderDefined(u) && !isDynamic(u);
+var isProviderDefined = (u) => hasProperty(u, ProviderDefinedTypeId);
+var isDynamic = (u) => hasProperty(u, DynamicTypeId);
+var Proto5 = {
+  [TypeId37]: {
+    _Requirements: identity
+  },
+  pipe() {
+    return pipeArguments(this, arguments);
+  },
+  addDependency() {
+    return userDefinedProto({
+      ...this
+    });
+  },
+  setParameters(parametersSchema) {
+    return userDefinedProto({
+      ...this,
+      parametersSchema
+    });
+  },
+  setSuccess(successSchema) {
+    return userDefinedProto({
+      ...this,
+      successSchema
+    });
+  },
+  setFailure(failureSchema) {
+    return userDefinedProto({
+      ...this,
+      failureSchema
+    });
+  },
+  annotate(tag2, value3) {
+    return userDefinedProto({
+      ...this,
+      annotations: add(this.annotations, tag2, value3)
+    });
+  },
+  annotateMerge(context4) {
+    return userDefinedProto({
+      ...this,
+      annotations: merge(this.annotations, context4)
+    });
+  }
+};
+var ProviderDefinedProto = {
+  ...Proto5,
+  [ProviderDefinedTypeId]: ProviderDefinedTypeId
+};
+var DynamicProto = {
+  ...Proto5,
+  [DynamicTypeId]: DynamicTypeId
+};
+var userDefinedProto = (options) => {
+  const self = Object.assign(Object.create(Proto5), options);
+  self.id = `effect/ai/Tool/${options.name}`;
+  return self;
+};
+var providerDefinedProto = (options) => Object.assign(Object.create(ProviderDefinedProto), {
+  ...options
+});
+var dynamicProto = (options) => {
+  const self = Object.assign(Object.create(DynamicProto), options);
+  self.id = `effect/ai/Tool/${options.name}`;
+  return self;
+};
+var make33 = (name, options) => {
+  const successSchema = options?.success ?? Void2;
+  const failureSchema = options?.failure ?? Never2;
+  return userDefinedProto({
+    name,
+    description: options?.description,
+    parametersSchema: options?.parameters ?? EmptyParams,
+    successSchema,
+    failureSchema,
+    failureMode: options?.failureMode ?? "error",
+    annotations: empty(),
+    needsApproval: options?.needsApproval
+  });
+};
+var dynamic = (name, options) => {
+  const successSchema = options?.success ?? Unknown2;
+  const failureSchema = options?.failure ?? Never2;
+  const rawParameters = options?.parameters ?? Unknown2;
+  const isEffectSchema = isSchema(rawParameters);
+  const parametersSchema = isEffectSchema ? rawParameters : Unknown2;
+  const jsonSchema = isEffectSchema ? undefined : rawParameters;
+  return dynamicProto({
+    name,
+    description: options?.description,
+    parametersSchema,
+    successSchema,
+    failureSchema,
+    failureMode: options?.failureMode ?? "error",
+    annotations: empty(),
+    needsApproval: options?.needsApproval,
+    jsonSchema
+  });
+};
+var providerDefined = (options) => (args2) => {
+  const failureMode = isNotUndefined(args2) && "failureMode" in args2 ? args2.failureMode : undefined;
+  const successSchema = options?.success ?? Void2;
+  const failureSchema = options?.failure ?? Never2;
+  return providerDefinedProto({
+    id: options.id,
+    name: options.customName,
+    providerName: options.providerName,
+    args: args2,
+    argsSchema: options?.args ?? Void2,
+    requiresHandler: options.requiresHandler ?? false,
+    parametersSchema: options?.parameters ?? Void2,
+    successSchema,
+    failureSchema,
+    failureMode: failureMode ?? "error"
+  });
+};
+
+class NameMapper {
+  #customToProvider = /* @__PURE__ */ new Map;
+  #providerToCustom = /* @__PURE__ */ new Map;
+  constructor(tools) {
+    for (const tool of tools) {
+      if (isProviderDefined(tool)) {
+        this.#customToProvider.set(tool.name, tool.providerName);
+        this.#providerToCustom.set(tool.providerName, tool.name);
+      }
+    }
+  }
+  get customNames() {
+    return Array.from(this.#customToProvider.keys());
+  }
+  get providerNames() {
+    return Array.from(this.#providerToCustom.keys());
+  }
+  getCustomName(providerName) {
+    return this.#providerToCustom.get(providerName) ?? providerName;
+  }
+  getProviderName(customName) {
+    return this.#customToProvider.get(customName) ?? customName;
+  }
+}
+var getDescription = (tool) => {
+  if (tool.description !== undefined) {
+    return tool.description;
+  }
+  if (isSchema(tool.parametersSchema)) {
+    return resolveDescription2(tool.parametersSchema.ast);
+  }
+  return;
+};
+var getJsonSchema = (tool, options) => {
+  if (isDynamic(tool) && tool.jsonSchema !== undefined) {
+    return tool.jsonSchema;
+  }
+  return getJsonSchemaFromSchema(tool.parametersSchema, options);
+};
+var getJsonSchemaFromSchema = (schema, options) => {
+  if (isNotUndefined(options?.transformer)) {
+    return options.transformer(schema).jsonSchema;
+  }
+  const document = toJsonSchemaDocument2(schema);
+  if (Object.keys(document.definitions).length > 0) {
+    document.schema.$defs = document.definitions;
+  }
+  return document.schema;
+};
+
+class Title extends (/* @__PURE__ */ Service()("effect/ai/Tool/Title")) {
+}
 
+class Meta extends (/* @__PURE__ */ Service()("effect/ai/Tool/Meta")) {
+}
+var Readonly = /* @__PURE__ */ Reference("effect/ai/Tool/Readonly", {
+  defaultValue: constFalse
+});
+var Destructive = /* @__PURE__ */ Reference("effect/ai/Tool/Destructive", {
+  defaultValue: constTrue
+});
+var Idempotent = /* @__PURE__ */ Reference("effect/ai/Tool/Idempotent", {
+  defaultValue: constFalse
+});
+var OpenWorld = /* @__PURE__ */ Reference("effect/ai/Tool/OpenWorld", {
+  defaultValue: constTrue
+});
+var Strict = /* @__PURE__ */ Reference("effect/ai/Tool/Strict", {
+  defaultValue: () => {
+    return;
+  }
+});
+var getStrictMode = (tool) => get(tool.annotations, Strict);
+var suspectProtoRx = /"__proto__"\s*:/;
+var suspectConstructorRx = /"constructor"\s*:/;
+function _parse(text) {
+  const obj = JSON.parse(text);
+  if (obj === null || typeof obj !== "object") {
+    return obj;
+  }
+  if (suspectProtoRx.test(text) === false && suspectConstructorRx.test(text) === false) {
+    return obj;
+  }
+  return filter13(obj);
+}
+function filter13(obj) {
+  let next2 = [obj];
+  while (next2.length) {
+    const nodes = next2;
+    next2 = [];
+    for (const node of nodes) {
+      if (Object.prototype.hasOwnProperty.call(node, "__proto__")) {
+        throw new SyntaxError("Object contains forbidden prototype property");
+      }
+      if (Object.prototype.hasOwnProperty.call(node, "constructor") && Object.prototype.hasOwnProperty.call(node.constructor, "prototype")) {
+        throw new SyntaxError("Object contains forbidden prototype property");
+      }
+      for (const key in node) {
+        const value3 = node[key];
+        if (value3 && typeof value3 === "object") {
+          next2.push(value3);
+        }
+      }
+    }
+  }
+  return obj;
+}
+var unsafeSecureJsonParse = (text) => {
+  const prevLimit = getStackTraceLimit();
+  setStackTraceLimit(0);
+  try {
+    return _parse(text);
+  } finally {
+    setStackTraceLimit(prevLimit);
+  }
+};
+var EmptyParams = /* @__PURE__ */ Record(String5, Never2);
+function isEmptyParamsRecord(indexSignature) {
+  return indexSignature.parameter === string2 && isNever2(indexSignature.type);
+}
 // ../core/src/agent-event.ts
 class AgentError extends exports_Schema.TaggedErrorClass()("@batonfx/core/AgentError", {
   message: exports_Schema.String,
@@ -34575,56 +34845,6 @@ var allowAll = exports_Layer.succeed(Permissions, Permissions.of({
   await: () => exports_Effect.succeed(exports_Option.none())
 }));
 
-// ../core/src/steering.ts
-class Steering extends exports_Context.Service()("@batonfx/core/Steering") {
-}
-
-// ../core/src/tool-context.ts
-class ToolContext extends exports_Context.Service()("@batonfx/core/ToolContext") {
-}
-var layerDefault = exports_Layer.sync(ToolContext, () => ToolContext.of({
-  signal: new AbortController().signal,
-  emit: () => exports_Effect.void,
-  sessionId: "local"
-}));
-
-// ../core/src/tool-executor.ts
-class ToolExecutor extends exports_Context.Service()("@batonfx/core/ToolExecutor") {
-}
-
-// ../core/src/turn-policy.ts
-var decision = {
-  continue: (overrides) => ({
-    _tag: "Continue",
-    ...overrides === undefined ? {} : { overrides }
-  }),
-  stop: { _tag: "Stop" }
-};
-var make33 = (decide) => ({ decide });
-var recurs2 = (n) => make33((info) => exports_Effect.succeed(info.turn < n + 1 ? decision.continue() : decision.stop));
-var defaultPolicy = recurs2(8);
-// ../core/src/agent-tool.ts
-var defaultParameters = exports_Schema.Struct({ prompt: exports_Schema.String });
-// ../core/src/handoff.ts
-var defaultTransferParameters = exports_Schema.Struct({ prompt: exports_Schema.String });
-// ../core/src/model-registry.ts
-class LanguageModelNotRegistered extends exports_Schema.TaggedErrorClass()("LanguageModelNotRegistered", {
-  provider: exports_Schema.String,
-  model: exports_Schema.String,
-  registration_key: exports_Schema.optionalKey(exports_Schema.String)
-}) {
-}
-
-class Service2 extends exports_Context.Service()("@batonfx/core/ModelRegistry") {
-}
-var register = exports_Effect.fn("ModelRegistry.register.call")(function* (input) {
-  const service4 = yield* Service2;
-  return yield* service4.register(input);
-});
-var registrations = exports_Effect.fn("ModelRegistry.registrations.call")(function* () {
-  const service4 = yield* Service2;
-  return yield* service4.registrations;
-});
 // ../core/src/skill-source.ts
 var exports_skill_source = {};
 __export(exports_skill_source, {
@@ -34680,6 +34900,70 @@ var selectListings = (skills, budgetTokens, recentlyUsed) => {
   }
   return selected;
 };
+
+// ../core/src/steering.ts
+class Steering extends exports_Context.Service()("@batonfx/core/Steering") {
+}
+
+// ../core/src/tool-context.ts
+class ToolContext extends exports_Context.Service()("@batonfx/core/ToolContext") {
+}
+var layerDefault = exports_Layer.sync(ToolContext, () => ToolContext.of({
+  signal: new AbortController().signal,
+  emit: () => exports_Effect.void,
+  sessionId: "local"
+}));
+
+// ../core/src/tool-executor.ts
+class ToolExecutor extends exports_Context.Service()("@batonfx/core/ToolExecutor") {
+}
+
+// ../core/src/turn-policy.ts
+var decision = {
+  continue: (overrides) => ({
+    _tag: "Continue",
+    ...overrides === undefined ? {} : { overrides }
+  }),
+  stop: { _tag: "Stop" }
+};
+var make34 = (decide) => ({ decide });
+var recurs2 = (n) => make34((info) => exports_Effect.succeed(info.turn < n + 1 ? decision.continue() : decision.stop));
+var defaultPolicy = recurs2(8);
+
+// ../core/src/agent.ts
+var activateSkillToolName = "activate_skill";
+var activateSkillParameters = exports_Schema.Struct({ name: exports_Schema.String });
+var activateSkillTool = exports_Tool.make(activateSkillToolName, {
+  description: "Load the full body for one listed Baton skill by name before applying that skill.",
+  parameters: activateSkillParameters,
+  success: exports_Schema.Struct({
+    name: exports_Schema.String,
+    body: exports_Schema.String,
+    allowedTools: exports_Schema.Array(exports_Schema.String)
+  })
+});
+// ../core/src/agent-tool.ts
+var defaultParameters = exports_Schema.Struct({ prompt: exports_Schema.String });
+// ../core/src/handoff.ts
+var defaultTransferParameters = exports_Schema.Struct({ prompt: exports_Schema.String });
+// ../core/src/model-registry.ts
+class LanguageModelNotRegistered extends exports_Schema.TaggedErrorClass()("LanguageModelNotRegistered", {
+  provider: exports_Schema.String,
+  model: exports_Schema.String,
+  registration_key: exports_Schema.optionalKey(exports_Schema.String)
+}) {
+}
+
+class Service2 extends exports_Context.Service()("@batonfx/core/ModelRegistry") {
+}
+var register = exports_Effect.fn("ModelRegistry.register.call")(function* (input) {
+  const service4 = yield* Service2;
+  return yield* service4.register(input);
+});
+var registrations = exports_Effect.fn("ModelRegistry.registrations.call")(function* () {
+  const service4 = yield* Service2;
+  return yield* service4.registrations;
+});
 // src/skill-loader.ts
 var DEFAULT_ROOTS = [".agents/skills", ".claude/skills", ".pi/skills"];
 var decoder3 = new TextDecoder;
@@ -34777,20 +35061,22 @@ var parseHeader = (source, block) => exports_Effect.sync(() => {
   }
   return parsed;
 }).pipe(exports_Effect.catchCause((cause) => exports_Effect.fail(sourceError(source, "Invalid SKILL.md frontmatter", cause))));
-var splitDocument = (source, content) => exports_Effect.sync(() => {
+var splitDocument = (source, content) => exports_Effect.gen(function* () {
   const normalized = content.replace(/^\uFEFF/, "").replace(/\r\n/g, `
 `);
   const lines = normalized.split(`
 `);
-  if (lines[0] !== "---")
-    throw new Error("missing opening frontmatter fence");
+  if (lines[0] !== "---") {
+    return yield* exports_Effect.fail(sourceError(source, "Invalid SKILL.md document: missing opening frontmatter fence"));
+  }
   const close2 = lines.findIndex((line, index2) => index2 > 0 && line === "---");
-  if (close2 === -1)
-    throw new Error("missing closing frontmatter fence");
+  if (close2 === -1) {
+    return yield* exports_Effect.fail(sourceError(source, "Invalid SKILL.md document: missing closing frontmatter fence"));
+  }
   return [lines.slice(1, close2).join(`
 `), lines.slice(close2 + 1).join(`
 `)];
-}).pipe(exports_Effect.catchCause((cause) => exports_Effect.fail(sourceError(source, "Invalid SKILL.md document", cause))));
+});
 var namespacedName = (path, relativeFile, explicitName) => {
   const directory = path.dirname(relativeFile);
   const segments = directory === "." ? [] : directory.split("/").filter((part) => part.length > 0);

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@batonfx/skills",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "private": false,
   "type": "module",
   "exports": {
@@ -14,7 +14,7 @@
     "typecheck": "bun tsc --noEmit"
   },
   "dependencies": {
-    "@batonfx/core": "0.1.0",
+    "@batonfx/core": "0.2.0",
     "effect": "4.0.0-beta.93"
   },
   "devDependencies": {

package/src/skill-loader.ts

@@ -126,14 +126,18 @@ const splitDocument = (
   source: string,
   content: string,
 ): Effect.Effect<readonly [string, string], SkillSource.SkillSourceError> =>
-  Effect.sync(() => {
+  Effect.gen(function* () {
     const normalized = content.replace(/^\uFEFF/, "").replace(/\r\n/g, "\n")
     const lines = normalized.split("\n")
-    if (lines[0] !== "---") throw new Error("missing opening frontmatter fence")
+    if (lines[0] !== "---") {
+      return yield* Effect.fail(sourceError(source, "Invalid SKILL.md document: missing opening frontmatter fence"))
+    }
     const close = lines.findIndex((line, index) => index > 0 && line === "---")
-    if (close === -1) throw new Error("missing closing frontmatter fence")
+    if (close === -1) {
+      return yield* Effect.fail(sourceError(source, "Invalid SKILL.md document: missing closing frontmatter fence"))
+    }
     return [lines.slice(1, close).join("\n"), lines.slice(close + 1).join("\n")] as const
-  }).pipe(Effect.catchCause((cause) => Effect.fail(sourceError(source, "Invalid SKILL.md document", cause))))
+  })
 
 const namespacedName = (path: Path.Path, relativeFile: string, explicitName: string | undefined): string => {
   const directory = path.dirname(relativeFile)