@trackunit/iris-app 2.16.5 → 2.16.6-alpha-2f5decf56c8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/iris-app",
-  "version": "2.16.5",
+  "version": "2.16.6-alpha-2f5decf56c8.0",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "src/index.js",
   "generators": "./generators.json",
@@ -10,7 +10,7 @@
     "node": ">=24.x"
   },
   "dependencies": {
-    "@trackunit/css-classname-utils": "0.0.114",
+    "@trackunit/css-classname-utils": "0.0.115-alpha-2f5decf56c8.0",
     "@typescript-eslint/types": "8.71.2",
     "@typescript-eslint/typescript-estree": "8.71.2",
     "pacote": "^21.5.1",
@@ -26,10 +26,10 @@
     "@nx/react": "23.3.0",
     "@npmcli/arborist": "^9.1.9",
     "win-ca": "^3.5.1",
-    "@trackunit/iris-app-build-utilities": "3.0.20",
-    "@trackunit/react-graphql-tools": "1.23.37",
-    "@trackunit/shared-utils": "1.22.33",
-    "@trackunit/iris-app-api": "2.13.8",
+    "@trackunit/iris-app-build-utilities": "3.0.21-alpha-2f5decf56c8.0",
+    "@trackunit/react-graphql-tools": "1.23.38-alpha-2f5decf56c8.0",
+    "@trackunit/shared-utils": "1.22.34-alpha-2f5decf56c8.0",
+    "@trackunit/iris-app-api": "2.13.9-alpha-2f5decf56c8.0",
     "tslib": "^2.6.2",
     "@clack/prompts": "^1.8.1",
     "@nx/devkit": "23.3.0",

package/src/generators/extend/files/AI_TOOLS_EXTENSION/.env.example__template__

@@ -0,0 +1,9 @@
+# Environment variables for local development
+# Copy this file to .env and fill in your values
+#
+# These variables are read by getSecret() from @trackunit/serverside-utils
+# The env var name must match the secretKey parameter exactly
+#
+# Example:
+# const apiKey = await getSecret({ context: c, secretKey: "API_KEY" });
+# API_KEY=your_api_key_here

package/src/generators/extend/files/AI_TOOLS_EXTENSION/extension-manifest.ts__template__

@@ -0,0 +1,16 @@
+import { AiToolsExtensionManifest } from '@trackunit/iris-app-api';
+import { toManifestAiTools } from '@trackunit/serverside-ai-tools';
+import { tools } from './src/tools';
+
+const aiToolsExtensionManifest: AiToolsExtensionManifest = {
+    id: "<%= projectName %>",
+    type: "AI_TOOLS_EXTENSION",
+    runtime: "DENO",
+    sourceRoot:  "dist/<%= projectRoot %>/",
+    dependencyDefinitionFile: "dist/<%= dependencyDefinitionFile %>",
+    name: "AI tools <%= projectName %>",
+    main: "index.js",
+    aiTools: toManifestAiTools(tools),
+};
+
+export default aiToolsExtensionManifest;

package/src/generators/extend/files/AI_TOOLS_EXTENSION/package.json__template__

@@ -0,0 +1,10 @@
+{
+  "name": "<%= importPath %>",
+  "type": "commonjs",
+  "dependencies": {
+    "@hono/node-server": "^1.19.17",
+    "dotenv": "16.3.1",
+    "hono": "^4.13.5",
+    "zod": "^3.25.76"
+  }
+}

package/src/generators/extend/files/AI_TOOLS_EXTENSION/src/index.ts__template__

@@ -0,0 +1,9 @@
+import { createAiToolsApp } from "@trackunit/serverside-ai-tools";
+import { tools } from "./tools";
+
+export default createAiToolsApp(tools, {
+  requiredScope: "account.view",
+  handlers: {
+    get_greeting: (_context, { name }) => ({ content: [{ type: "text", text: `Hello, ${name}!` }] }),
+  },
+}).fetch;

package/src/generators/extend/files/AI_TOOLS_EXTENSION/src/local-serve.ts__template__

@@ -0,0 +1,11 @@
+// Auto-generated: mimics the production serverside runtime for local development.
+// Do not edit — SDK updates may overwrite changes.
+import "dotenv/config";
+
+import { serve } from "@hono/node-server";
+
+import handler from "./index";
+
+const port = Number(process.env.PORT) || 8000;
+
+serve({ fetch: handler, port });

package/src/generators/extend/files/AI_TOOLS_EXTENSION/src/tools.ts__template__

@@ -0,0 +1,17 @@
+import { defineAiTools } from "@trackunit/serverside-ai-tools";
+import { z } from "zod";
+
+// Definitions only: extension-manifest.ts imports this file at build time.
+// AI clients see the tools as `<namespace>_<name>`. Pick a short namespace that names your app: it must be
+// unique across Trackunit, and submit rejects a reserved or taken one.
+export const tools = defineAiTools({
+  namespace: "<%= aiToolsNamespace %>",
+  tools: {
+    get_greeting: {
+      title: "Get greeting",
+      description: "Returns a greeting for the given name. Replace this example with your app's tools.",
+      inputSchema: { name: z.string().min(1).describe("Who to greet.") },
+      annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    },
+  },
+});

package/src/generators/extend/files/non-ui-test/extension-manifest.spec.ts__template__

@@ -5,7 +5,7 @@ describe("extension manifest", () => {
     expect(extensionManifest).toMatchObject({
       id: "<%= projectName %>",
       type: "<%= type %>",
-      sourceRoot: "<% if (type === 'SERVERSIDE_API_EXTENSION') { %>dist/<%= projectRoot %>/<% } else { %><%= sourceRoot %><% } %>",
+      sourceRoot: "<% if (type === 'SERVERSIDE_API_EXTENSION' || type === 'AI_TOOLS_EXTENSION') { %>dist/<%= projectRoot %>/<% } else { %><%= sourceRoot %><% } %>",
     });
   });
 });

package/src/generators/extend/generator.d.ts

@@ -10,6 +10,11 @@ type ServersideGraphqlOptions = {
  * Adds public-schema codegen and a typed Hono example to a generated serverside extension.
  */
 export declare const addServersideGraphql: (tree: Tree, options: ServersideGraphqlOptions) => Promise<void>;
+/**
+ * A valid aiTools namespace from the project name: kebab-case, starting with a letter, short enough that
+ * `<namespace>_<tool>` stays within the 60 characters AI clients allow.
+ */
+export declare const toAiToolsNamespace: (projectName: string) => string;
 /**
  * Iris App Extension Generator.
  *

package/src/generators/extend/generator.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IrisAppExtensionGenerator = exports.addServersideGraphql = void 0;
+exports.IrisAppExtensionGenerator = exports.toAiToolsNamespace = exports.addServersideGraphql = void 0;
 const tslib_1 = require("tslib");
 const devkit_1 = require("@nx/devkit");
 const eslint_1 = require("@nx/eslint");
@@ -55,6 +55,19 @@ const addServersideGraphql = async (tree, options) => {
     });
 };
 exports.addServersideGraphql = addServersideGraphql;
+/**
+ * A valid aiTools namespace from the project name: kebab-case, starting with a letter, short enough that
+ * `<namespace>_<tool>` stays within the 60 characters AI clients allow.
+ */
+const toAiToolsNamespace = (projectName) => {
+    const kebab = projectName
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    const namespace = /^[a-z]/.test(kebab) ? kebab : `app-${kebab}`;
+    return namespace.slice(0, 30).replace(/-+$/, "");
+};
+exports.toAiToolsNamespace = toAiToolsNamespace;
 const getPackageVersion = async (packageName) => (await (0, get_package_manifest_1.getPackageManifest)(packageName)).version;
 function normalizeOptions(tree, options) {
     const name = (0, devkit_1.names)(options.name).fileName;
@@ -95,6 +108,7 @@ const IrisAppExtensionGenerator = async function (tree, options) {
         ...normalizedOptions,
         ...(0, devkit_1.names)(normalizedOptions.name),
         offsetFromRoot: (0, devkit_1.offsetFromRoot)(normalizedOptions.projectRoot),
+        aiToolsNamespace: (0, exports.toAiToolsNamespace)(normalizedOptions.projectName),
         template: "",
     };
     const irisAppExtensionType = normalizedOptions.type;
@@ -230,6 +244,20 @@ const IrisAppExtensionGenerator = async function (tree, options) {
             return projectJson;
         });
     }
+    if (irisAppExtensionType === "AI_TOOLS_EXTENSION") {
+        const serversideAiToolsVersion = await getPackageVersion("@trackunit/serverside-ai-tools");
+        (0, devkit_1.updateJson)(tree, (0, devkit_1.joinPathFragments)(normalizedOptions.projectRoot, "package.json"), packageJson => {
+            packageJson.dependencies = {
+                ...packageJson.dependencies,
+                "@trackunit/serverside-ai-tools": serversideAiToolsVersion,
+            };
+            return packageJson;
+        });
+        if (normalizedOptions.updatePackageJson) {
+            // The extension manifest imports the package at build time, from the workspace.
+            (0, devkit_1.addDependenciesToPackageJson)(tree, { "@trackunit/serverside-ai-tools": serversideAiToolsVersion }, {});
+        }
+    }
     if (normalizedOptions.graphql) {
         await (0, exports.addServersideGraphql)(tree, {
             projectName: normalizedOptions.projectName,

package/src/generators/extend/schema.d.ts

@@ -14,6 +14,7 @@ export interface IrisAppExtensionGeneratorSchema {
     | "ASSET_HOME_EXTENSION"
     | "ASSET_EVENTS_ACTIONS_EXTENSION"
     | "LIFECYCLE_EXTENSION"
-    | "SERVERSIDE_API_EXTENSION";
+    | "SERVERSIDE_API_EXTENSION"
+    | "AI_TOOLS_EXTENSION";
   graphql?: boolean;
 }

package/src/generators/extend/schema.json

@@ -56,7 +56,8 @@
           "CUSTOMER_HOME_EXTENSION",
           "IRIS_APP_SETTINGS_EXTENSION",
           "LIFECYCLE_EXTENSION",
-          "SERVERSIDE_API_EXTENSION"
+          "SERVERSIDE_API_EXTENSION",
+          "AI_TOOLS_EXTENSION"
         ]
       }
     },