@yaklabs-ai/plugin-sdk 0.15.3 → 0.27.0

package/dist/kay-agent-testing.js

@@ -98,6 +98,65 @@ var SYSTEM_ONE_LIMITS = {
   maxForecastHorizon: 64
 };
 
+// packages/plugin-sdk/dist/log.js
+function createKayPluginLog(write, bound = {}) {
+  const at = (level) => (name, message, details) => {
+    try {
+      write({
+        level,
+        name,
+        message,
+        ...details?.error === void 0 ? {} : { error: details.error },
+        ...details?.sessionId === void 0 ? {} : { sessionId: details.sessionId },
+        attributes: { ...bound, ...details?.attributes }
+      });
+    } catch {
+    }
+  };
+  return {
+    debug: at("debug"),
+    info: at("info"),
+    warn: at("warn"),
+    error: at("error"),
+    child: (attributes) => createKayPluginLog(write, { ...bound, ...attributes })
+  };
+}
+
+// packages/plugin-sdk/dist/kay-agent/declared-tool.js
+function permissionHint(permission) {
+  const { kind, ruleKey, resourceArgs } = permission;
+  return {
+    kind,
+    ...ruleKey === void 0 ? {} : { ruleKey },
+    ...resourceArgs === void 0 ? {} : {
+      deriveResources: (input) => resourceArgs.flatMap((arg) => {
+        const value = input[arg];
+        return typeof value === "string" ? [value] : [];
+      })
+    }
+  };
+}
+function declaredToolDefinition(tool, execute) {
+  const { parameters, description, requiresAuth, permission } = tool;
+  if (parameters === void 0 || description === void 0) {
+    throw new Error(`Tool '${tool.toolName}' declares no parameters in kay-plugin.json, so its definition comes from code.`);
+  }
+  return {
+    name: tool.toolName,
+    label: tool.displayName ?? tool.toolName,
+    description,
+    parameters,
+    ...requiresAuth === void 0 ? {} : {
+      requiresAuth: {
+        serviceId: requiresAuth.serviceId,
+        ...requiresAuth.schemeId === void 0 ? {} : { schemeId: requiresAuth.schemeId }
+      }
+    },
+    ...permission === void 0 ? {} : { permission: permissionHint(permission) },
+    execute
+  };
+}
+
 // packages/plugin-primitives/dist/is-object.js
 function isObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -205,6 +264,7 @@ function fauxKayAgentCapabilities() {
       download: unwired("webSession.download")
     },
     process: { run: unwired("process.run") },
+    compiler: { bundleBrowser: unwired("compiler.bundleBrowser") },
     whiteboard: {
       listTypes: unwired("whiteboard.listTypes"),
       forType: () => ({
@@ -227,6 +287,7 @@ function fauxKayAgentCapabilities() {
     // surface as `{ ok: false }`, never a throw. A test driving one overrides this handle.
     interaction: { browserPane: UNWIRED_SURFACE, desktop: UNWIRED_SURFACE },
     interceptToolCall: () => void 0,
+    implementTool: () => void 0,
     // Throws `not-served`, so the plugin's own `catch` runs. A test that wants answers overrides
     // this handle after the spread.
     systemOne: createUnavailableSystemOneClient(),
@@ -234,12 +295,15 @@ function fauxKayAgentCapabilities() {
     // rejecting double would fail tests for a reason production never has. A test asserting what
     // its plugin publishes overrides this handle after the spread.
     events: { publish: () => void 0 },
-    // A test double has no user-time port, so it answers the zone as unknown — the same contract
+    // A test double has no user-time port, so it answers the zone as unknown - the same contract
     // the real capability keeps for a zone the host cannot read. A test that exercises a plugin's
     // zone-of-record path overrides this handle after the spread.
     time: {
       snapshot: () => ({ nowMs: 0, zone: "UTC", zoneSource: "utc-fallback" })
     },
+    // Accepts and drops, like `events`: the real logger never throws. A test asserting what its
+    // plugin logs overrides this handle after the spread.
+    log: createKayPluginLog(() => void 0),
     // Answers every call `error` naming itself, keeping the real contract's promise never to
     // reject. A test that exercises a plugin's file I/O overrides this handle after the spread.
     userFiles: Object.fromEntries(USER_FILE_METHODS.map((name) => [
@@ -249,9 +313,30 @@ function fauxKayAgentCapabilities() {
         detail: `userFiles.${name} is not wired in this test double`
       })
     ])),
-    // A test double runs outside any session, so it has no family folder — the same answer the
+    // A test double runs outside any session, so it has no family folder - the same answer the
     // real capability gives. A test that exercises one overrides this handle after the spread.
-    familyFolder: { path: async () => void 0 }
+    familyFolder: { path: async () => void 0 },
+    // Answers `failed` naming itself, keeping the real port's promise never to reject. It returns a
+    // port for any name, where the real one throws for a server the manifest does not declare. A
+    // test that exercises a plugin's MCP calls passes its own fake port.
+    vendoredMcp: {
+      port: (server) => ({
+        invoke: async () => ({
+          ok: false,
+          reason: "failed",
+          message: `vendoredMcp.port("${server}") is not wired in this test double`
+        })
+      })
+    },
+    // Answers `unavailable` naming itself, keeping the real call's promise never to reject. A test
+    // that exercises its plugin's own endpoints passes its own handle.
+    endpoints: {
+      invoke: async (endpoint) => ({
+        ok: false,
+        reason: "unavailable",
+        message: `endpoints.invoke("${endpoint}") is not wired in this test double`
+      })
+    }
   };
 }
 function createTestClock(startMs, options = {}) {
@@ -296,6 +381,13 @@ function defaultTestToolContext() {
 async function invokeToolForTest(tool, params, ctx = defaultTestToolContext()) {
   return tool.execute("test-call", params, void 0, void 0, ctx);
 }
+function describedToolForTest(contract, localId, execute) {
+  const tool = contract.kayAgentTools?.find((declared) => declared.localId === localId);
+  if (tool === void 0) {
+    throw new Error(`The contract declares no kay.agent tool '${localId}'.`);
+  }
+  return declaredToolDefinition(tool, execute);
+}
 function producedResourcesForTest(result) {
   const recorded = recordProducedResources(result.details).details;
   const read = readProducedResourceDeclarations(recorded);
@@ -307,6 +399,7 @@ function producedResourcesForTest(result) {
 }
 export {
   createTestClock,
+  describedToolForTest,
   fauxAuthContext,
   fauxKayAgentCapabilities,
   invokeToolForTest,