@standardagents/spec 0.11.11 → 0.12.0

package/dist/index.js

@@ -3,6 +3,9 @@ function defineModel(options) {
   if (!options.name) {
     throw new Error("Model name is required");
   }
+  if (options.name.includes("/")) {
+    throw new Error(`Model name cannot contain '/'. Reserved for namespace qualification.`);
+  }
   if (!options.provider) {
     throw new Error("Model provider is required");
   }
@@ -34,6 +37,11 @@ function defineModel(options) {
 }
 
 // src/tools.ts
+function validateToolName(name) {
+  if (name.includes("/")) {
+    throw new Error(`Tool name cannot contain '/'. Reserved for namespace qualification.`);
+  }
+}
 function defineTool(options) {
   return {
     description: options.description,
@@ -41,7 +49,8 @@ function defineTool(options) {
     execute: options.execute,
     tenvs: options.tenvs ?? null,
     executionMode: options.executionMode,
-    executionProvider: options.executionProvider
+    executionProvider: options.executionProvider,
+    uses: options.uses
   };
 }
 
@@ -50,6 +59,9 @@ function definePrompt(options) {
   if (!options.name) {
     throw new Error("Prompt name is required");
   }
+  if (options.name.includes("/")) {
+    throw new Error(`Prompt name cannot contain '/'. Reserved for namespace qualification.`);
+  }
   if (!options.toolDescription) {
     throw new Error("Prompt toolDescription is required");
   }
@@ -86,24 +98,36 @@ function definePrompt(options) {
 }
 
 // src/hooks.ts
-function defineHook(hookName, implementation) {
-  const validHooks = [
-    "filter_messages",
-    "prefilter_llm_history",
-    "before_create_message",
-    "after_create_message",
-    "before_update_message",
-    "after_update_message",
-    "before_store_tool_result",
-    "after_tool_call_success",
-    "after_tool_call_failure"
-  ];
-  if (!validHooks.includes(hookName)) {
+var VALID_HOOKS = [
+  "filter_messages",
+  "prefilter_llm_history",
+  "before_create_message",
+  "after_create_message",
+  "before_update_message",
+  "after_update_message",
+  "before_store_tool_result",
+  "after_tool_call_success",
+  "after_tool_call_failure"
+];
+function defineHook(options) {
+  if (!VALID_HOOKS.includes(options.hook)) {
+    throw new Error(
+      `Invalid hook type '${options.hook}'. Valid hooks: ${VALID_HOOKS.join(", ")}`
+    );
+  }
+  if (!options.id || typeof options.id !== "string") {
+    throw new Error("Hook id is required and must be a non-empty string");
+  }
+  if (!/^[a-z][a-z0-9_]*$/.test(options.id)) {
     throw new Error(
-      `Invalid hook name '${hookName}'. Valid hooks: ${validHooks.join(", ")}`
+      `Hook id '${options.id}' must be snake_case (lowercase letters, numbers, underscores, starting with letter)`
     );
   }
-  return implementation;
+  return {
+    hook: options.hook,
+    id: options.id,
+    execute: options.execute
+  };
 }
 
 // src/effects.ts
@@ -127,6 +151,9 @@ function defineAgent(options) {
   if (!options.name) {
     throw new Error("Agent name is required");
   }
+  if (options.name.includes("/")) {
+    throw new Error(`Agent name cannot contain '/'. Reserved for namespace qualification.`);
+  }
   if (!options.sideA) {
     throw new Error("Agent sideA configuration is required");
   }
@@ -215,9 +242,26 @@ function mapReasoningLevel(level, reasoningLevels) {
   }
   return reasoningLevels[nearest];
 }
+
+// src/packing.ts
+function isPacked(metadata) {
+  return !!metadata?.__package;
+}
+function belongsToPackage(metadata, packageId) {
+  return metadata?.__package?.packageId === packageId;
+}
+function isVisibleInNamespace(metadata, namespace, isEntryPoint = false) {
+  const hasPkg = isPacked(metadata);
+  if (namespace.type === "global") {
+    return !hasPkg || isEntryPoint;
+  }
+  const isOwnPackage = hasPkg && metadata.__package.packageId === namespace.packageId;
+  return isOwnPackage || hasPkg && isEntryPoint;
+}
 export {
   ProviderError,
   THREAD_ENDPOINT_SYMBOL,
+  belongsToPackage,
   defineAgent,
   defineController,
   defineEffect,
@@ -226,7 +270,10 @@ export {
   definePrompt,
   defineThreadEndpoint,
   defineTool,
+  isPacked,
   isThreadEndpoint,
-  mapReasoningLevel
+  isVisibleInNamespace,
+  mapReasoningLevel,
+  validateToolName
 };
 //# sourceMappingURL=index.js.map