@gram-ai/create-function 0.0.0-empty → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Speakeasy Development, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":""}

package/dist/main.js

@@ -0,0 +1,156 @@
+import { existsSync } from "node:fs";
+import fs from "node:fs/promises";
+import { join, resolve } from "node:path";
+import process from "node:process";
+import { $ } from "zx";
+import { isCancel, log, taskLog } from "@clack/prompts";
+import { parse } from "@bomb.sh/args";
+import pkg from "../package.json" with { type: "json" };
+import { confirmOrClack, selectOrClack, textOrClack, yn, } from "./prompts/helpers.js";
+const packageNameRE = /^(@?[a-z0-9-_]+\/)?[a-z0-9-_]+$/;
+const knownPackageManagers = new Set(["npm", "yarn", "pnpm", "bun", "deno"]);
+async function init(argv) {
+    let packageManager = "npm";
+    let detectedPM = process.env["npm_config_user_agent"]?.split("/")[0] || "";
+    if (knownPackageManagers.has(detectedPM)) {
+        packageManager = detectedPM;
+    }
+    const args = parse(argv, {
+        alias: { y: "yes" },
+        string: ["template", "name", "dir", "git", "install"],
+        boolean: ["yes"],
+    });
+    const template = await selectOrClack({
+        message: "Pick a framework",
+        options: [
+            {
+                value: "gram",
+                label: "Gram",
+                hint: "Simple framework focused on getting you up and runnning with minimal code.",
+            },
+            {
+                value: "mcp",
+                label: "MCP",
+                hint: "Use the official @modelcontextprotocol/sdk package to build an MCP server and deploy it to Gram.",
+            },
+        ],
+    })(args.template);
+    if (isCancel(template)) {
+        log.info("Operation cancelled.");
+        return;
+    }
+    const nameArg = args.name?.trim();
+    const name = await textOrClack({
+        message: "What do you want to call your project?",
+        defaultValue: "gram-mcp-server",
+        validate: (value) => {
+            if (packageNameRE.test(value || "")) {
+                return undefined;
+            }
+            return [
+                "Package names can be scoped or unscoped and must only contain alphanumeric characters, dashes and underscores.",
+                "Examples:",
+                "my-mcp-server",
+                "@fancy-org/mcp-server",
+            ].join(" ");
+        },
+    })(nameArg);
+    if (isCancel(name)) {
+        log.info("Operation cancelled.");
+        return;
+    }
+    const rootDir = name.split("/").pop()?.trim() || "gram-func";
+    const dirArg = args.dir?.trim();
+    let dir = await textOrClack({
+        message: "Where do you want to create it?",
+        initialValue: rootDir,
+        defaultValue: rootDir,
+        validate: (value) => {
+            const trimmed = value?.trim() || "";
+            if (trimmed.length === 0) {
+                return "Directory name cannot be empty.";
+            }
+            if (existsSync(trimmed)) {
+                return `Directory ${trimmed} already exists. Please choose a different name.`;
+            }
+            return undefined;
+        },
+    })(dirArg);
+    if (isCancel(dir)) {
+        log.info("Operation cancelled.");
+        return;
+    }
+    dir = dir.trim();
+    const initGit = await confirmOrClack({
+        message: "Initialize a git repository?",
+    })(args.yes || yn(args.git ?? false));
+    if (isCancel(initGit)) {
+        log.info("Operation cancelled.");
+        return;
+    }
+    const installDeps = await confirmOrClack({
+        message: `Install dependencies with ${packageManager}?`,
+    })(args.yes || yn(args.install ?? false));
+    if (isCancel(installDeps)) {
+        log.info("Operation cancelled.");
+        return;
+    }
+    const tlog = taskLog({
+        title: "Setting up project",
+    });
+    tlog.message("Scaffolding");
+    const dirname = import.meta.dirname;
+    const templateDir = resolve(join(dirname, "..", `gram-template-${template}`));
+    await fs.cp(templateDir, dir, {
+        recursive: true,
+        filter: (src) => !src.includes("node_modules") &&
+            !src.includes(".git") &&
+            !src.includes("dist"),
+    });
+    let gramFuncsVersion = pkg.devDependencies["@gram-ai/functions"];
+    if (gramFuncsVersion == null || gramFuncsVersion.startsWith("workspace:")) {
+        // This templating package and `@gram-ai/functions` are versioned in
+        // lockstep so we can just use the matching version.
+        gramFuncsVersion = `^${pkg.version}`;
+    }
+    if (yn(process.env["GRAM_DEV"]) &&
+        existsSync(resolve(dirname, "..", "..", "functions"))) {
+        // For local development, use the local version of `@gram-ai/functions`
+        // if it exists.
+        const localPkgPath = resolve(dirname, "..", "..", "functions");
+        gramFuncsVersion = `file:${localPkgPath}`;
+        tlog.message(`Using local @gram-ai/functions from ${localPkgPath}`);
+    }
+    tlog.message("Updating package.json");
+    const pkgPath = await fs.readFile(join(dir, "package.json"), "utf-8");
+    const dstPkg = JSON.parse(pkgPath);
+    dstPkg.name = name;
+    const deps = dstPkg.dependencies;
+    if (deps?.["@gram-ai/functions"] != null) {
+        deps["@gram-ai/functions"] = gramFuncsVersion;
+    }
+    await fs.writeFile(join(dir, "package.json"), JSON.stringify(dstPkg, null, 2));
+    const contributingPath = join(dir, "CONTRIBUTING.md");
+    if (existsSync(contributingPath)) {
+        tlog.message("Creating symlinks for CONTRIBUTING.md");
+        await fs.symlink("CONTRIBUTING.md", join(dir, "AGENTS.md"));
+        await fs.symlink("CONTRIBUTING.md", join(dir, "CLAUDE.md"));
+    }
+    if (initGit) {
+        tlog.message("Initializing git repository");
+        await $ `git init ${dir}`;
+    }
+    if (installDeps) {
+        tlog.message(`Installing dependencies with ${packageManager}`);
+        await $ `cd ${dir} && ${packageManager} install`;
+    }
+    tlog.success(`All done! Run \`cd ${dir} && ${packageManager} run build\` to build your first Gram Function.`);
+}
+try {
+    await init(process.argv);
+}
+catch (err) {
+    log.error(`Unexpected error: ${err}`);
+    process.exit(1);
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"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"}

package/dist/prompts/helpers.d.ts

@@ -0,0 +1,6 @@
+import { type ConfirmOptions, type SelectOptions, type TextOptions } from "@clack/prompts";
+export declare function yn(value: boolean | string | undefined): boolean;
+export declare function textOrClack(options: TextOptions): (value: string | undefined) => Promise<string | symbol>;
+export declare function selectOrClack<T>(options: SelectOptions<T>): (value: T | undefined) => Promise<T | symbol>;
+export declare function confirmOrClack(options: ConfirmOptions): (value: boolean | undefined) => Promise<boolean | symbol>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/prompts/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/prompts/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAC;AAGxB,wBAAgB,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAI/D;AAED,wBAAgB,WAAW,CACzB,OAAO,EAAE,WAAW,GACnB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAEzD;AAED,wBAAgB,aAAa,CAAC,CAAC,EAC7B,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GACxB,CAAC,KAAK,EAAE,CAAC,GAAG,SAAS,KAAK,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,CAE/C;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,GACtB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,KAAK,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,CAE3D"}

package/dist/prompts/helpers.js

@@ -0,0 +1,19 @@
+import { confirm, select, text, } from "@clack/prompts";
+const y = new Set(["y", "yes", "true", "t", "1"]);
+export function yn(value) {
+    if (value == null)
+        return false;
+    if (typeof value === "boolean")
+        return value;
+    return y.has(value.toLowerCase());
+}
+export function textOrClack(options) {
+    return async (value) => value || text(options);
+}
+export function selectOrClack(options) {
+    return async (value) => value || select(options);
+}
+export function confirmOrClack(options) {
+    return async (value) => value || confirm(options);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/prompts/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/prompts/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,MAAM,EACN,IAAI,GAIL,MAAM,gBAAgB,CAAC;AAExB,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAClD,MAAM,UAAU,EAAE,CAAC,KAAmC;IACpD,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,OAAoB;IAEpB,OAAO,KAAK,EAAE,KAAyB,EAAE,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,OAAyB;IAEzB,OAAO,KAAK,EAAE,KAAoB,EAAE,EAAE,CAAC,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAAuB;IAEvB,OAAO,KAAK,EAAE,KAA0B,EAAE,EAAE,CAAC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;AACzE,CAAC"}

package/gram-template-gram/.gitignore

@@ -0,0 +1,9 @@
+node_modules
+dist
+.env
+.DS_Store
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+*.tsbuildinfo

package/gram-template-gram/CONTRIBUTING.md

@@ -0,0 +1,399 @@
+# Project Contribution Guide
+
+- This is a Node.js project using TypeScript to build [Gram](https://gram.ai) Functions.
+- The codebase assumes Node.js v22 or later is in use and TypeScript v5.9 or later is required.
+- When working in this codebase prefer using the Web APIs and Node.js standard library where possible instead of third-party libraries.
+
+## Project Structure
+
+- `src/` - Contains the source TypeScript code for the Gram Functions.
+- `dist/` - Output directory for the built code (generated after running `npm run build`).
+- `package.json` - Defines project metadata, dependencies, and scripts.
+- `tsconfig.json` - TypeScript configuration file.
+
+## `package.json` scripts
+
+- `build` - Bundles the Gram Functions code into a zip file for deployment and places it in the `dist/` directory.
+- `lint` - Runs the TypeScript compiler in `noEmit` mode to check for type errors.
+
+<details open>
+<summary><strong>Guide: Using `@gram-ai/functions`</strong></summary>
+
+## Core Concepts
+
+### The Gram Instance
+
+The `Gram` class is the main entry point for defining tools. You create an instance and chain `.tool()` calls to register multiple tools:
+
+```typescript
+import { Gram } from "@gram-ai/functions";
+import * as z from "zod/mini";
+
+const g = new Gram()
+  .tool({
+    name: "add",
+    description: "Add two numbers",
+    inputSchema: { a: z.number(), b: z.number() },
+    async execute(ctx, input) {
+      return ctx.json({ sum: input.a + input.b });
+    },
+  })
+  .tool({
+    name: "multiply",
+    description: "Multiply two numbers",
+    inputSchema: { a: z.number(), b: z.number() },
+    async execute(ctx, input) {
+      return ctx.json({ product: input.a * input.b });
+    },
+  });
+
+export const handleToolCall = g.handleToolCall;
+```
+
+### Tool Definition
+
+Each tool requires:
+
+- **name**: A unique identifier for the tool
+- **description** (optional): Human-readable description of what the tool does
+- **inputSchema**: A Zod schema object defining the expected input parameters
+- **variables** (optional): Environment variables the tool needs
+- **execute**: An async function that implements the tool logic
+
+### Tool Context
+
+The `execute` function receives a `ctx` (context) object with helper methods:
+
+#### `ctx.json(data)`
+
+Returns a JSON response:
+
+```typescript
+async execute(ctx, input) {
+  return ctx.json({ result: "success", value: 42 });
+}
+```
+
+#### `ctx.text(data)`
+
+Returns a plain text response:
+
+```typescript
+async execute(ctx, input) {
+  return ctx.text("Operation completed successfully");
+}
+```
+
+#### `ctx.html(data)`
+
+Returns an HTML response:
+
+```typescript
+async execute(ctx, input) {
+  return ctx.html("<h1>Hello, World!</h1>");
+}
+```
+
+#### `ctx.fail(data, options?)`
+
+Throws an error response (never returns):
+
+```typescript
+async execute(ctx, input) {
+  if (!input.value) {
+    ctx.fail({ error: "value is required" }, { status: 400 });
+  }
+  // ...
+}
+```
+
+#### `ctx.signal`
+
+An `AbortSignal` for handling cancellation:
+
+```typescript
+async execute(ctx, input) {
+  const response = await fetch(input.url, { signal: ctx.signal });
+  return ctx.json(await response.json());
+}
+```
+
+#### `ctx.vars`
+
+Access to environment variables defined in the tool's `variables` property:
+
+```typescript
+.tool({
+  name: "api_call",
+  inputSchema: { endpoint: z.string() },
+  variables: {
+    API_KEY: { description: "API key for authentication" }
+  },
+  async execute(ctx, input) {
+    const apiKey = ctx.vars.API_KEY;
+    // Use apiKey...
+  },
+})
+```
+
+## Input Validation
+
+Input schemas are defined using [Zod](https://zod.dev/):
+
+```typescript
+import * as z from "zod/mini";
+
+.tool({
+  name: "create_user",
+  inputSchema: {
+    email: z.string().check(z.email()),
+    age: z.number().check(z.min(18)),
+    name: z.optional(z.string()),
+  },
+  async execute(ctx, input) {
+    // input is fully typed based on the schema
+    return ctx.json({ userId: "123" });
+  },
+})
+```
+
+### Lax Mode
+
+By default, the framework strictly validates input. You can enable lax mode to allow unvalidated input to pass through:
+
+```typescript
+const g = new Gram({ lax: true });
+```
+
+## Environment Variables
+
+### Runtime Environment
+
+Pass environment variables are read from `process.env` by default, but you can override them when creating the `Gram` instance:
+
+```typescript
+const g = new Gram({
+  env: {
+    API_KEY: "secret-key",
+    BASE_URL: "https://api.example.com",
+  },
+});
+```
+
+If not provided, the framework falls back to `process.env`.
+
+### Tool Variables
+
+Declare which environment variables a tool needs:
+
+```typescript
+.tool({
+  name: "weather",
+  inputSchema: { city: z.string() },
+  variables: {
+    WEATHER_API_KEY: {
+      description: "API key for weather service"
+    }
+  },
+  async execute(ctx, input) {
+    const apiKey = ctx.vars.WEATHER_API_KEY;
+    // Make API call...
+  },
+})
+```
+
+## Response Types
+
+The framework supports multiple response types. All response methods return Web API `Response` objects.
+
+### JSON Response
+
+```typescript
+return ctx.json({
+  status: "success",
+  data: { id: 123, name: "Example" },
+});
+```
+
+### Text Response
+
+```typescript
+return ctx.text("Plain text response");
+```
+
+### HTML Response
+
+```typescript
+return ctx.html(`
+  <!DOCTYPE html>
+  <html>
+    <body><h1>Hello</h1></body>
+  </html>
+`);
+```
+
+### Custom Response
+
+You can also return a plain `Response` object:
+
+```typescript
+return new Response(data, {
+  status: 200,
+  headers: {
+    "Content-Type": "application/xml",
+    "X-Custom-Header": "value",
+  },
+});
+```
+
+## Error Handling
+
+### Using `ctx.fail()`
+
+Use `ctx.fail()` to throw error responses:
+
+```typescript
+async execute(ctx, input) {
+  if (!input.userId) {
+    ctx.fail(
+      { error: "userId is required" },
+      { status: 400 }
+    );
+  }
+
+  const user = await fetchUser(input.userId);
+  if (!user) {
+    ctx.fail(
+      { error: "User not found" },
+      { status: 404 }
+    );
+  }
+
+  return ctx.json({ user });
+}
+```
+
+Errors automatically include a stack trace in the response.
+
+### Using `assert()`
+
+The `assert` function provides a convenient way to validate conditions and throw error responses:
+
+```typescript
+import { assert } from "@gram-ai/functions";
+
+async execute(ctx, input) {
+  assert(input.userId, { error: "userId is required" }, { status: 400 });
+
+  const user = await fetchUser(input.userId);
+  assert(user, { error: "User not found" }, { status: 404 });
+
+  return ctx.json({ user });
+}
+```
+
+The `assert` function throws a `Response` object when the condition is false. The framework catches all thrown values, and if any happen to be a `Response` instance, they will be returned to the client.
+
+Key points about `assert`:
+
+- First parameter is the condition to check
+- Second parameter is the error data (must include an `error` field)
+- Third parameter is optional and can specify the status code (defaults to 500)
+- Automatically includes a stack trace in the response
+- Uses TypeScript's assertion type to narrow types when the assertion passes
+
+## Manifest Generation
+
+Generate a manifest of all registered tools:
+
+```typescript
+const g = new Gram()
+  .tool({
+    /* ... */
+  })
+  .tool({
+    /* ... */
+  });
+
+const manifest = g.manifest();
+// {
+//   version: "0.0.0",
+//   tools: [
+//     {
+//       name: "tool1",
+//       description: "...",
+//       inputSchema: "...", // JSON Schema string
+//       variables: { ... }
+//     },
+//     ...
+//   ]
+// }
+```
+
+## Handling Tool Calls
+
+Export the `handleToolCall` method to process incoming requests:
+
+```typescript
+const g = new Gram()
+  .tool({
+    /* ... */
+  })
+  .tool({
+    /* ... */
+  });
+
+export const handleToolCall = g.handleToolCall;
+```
+
+You can also call tools programmatically:
+
+```typescript
+const response = await g.handleToolCall({
+  name: "add",
+  input: { a: 5, b: 3 },
+});
+
+const data = await response.json();
+console.log(data); // { sum: 8 }
+```
+
+With abort signal support:
+
+```typescript
+const controller = new AbortController();
+
+const responsePromise = g.handleToolCall(
+  { name: "longRunning", input: {} },
+  { signal: controller.signal },
+);
+
+// Cancel after 5 seconds
+setTimeout(() => controller.abort(), 5000);
+```
+
+## Type Safety
+
+The framework provides full TypeScript type inference:
+
+```typescript
+const g = new Gram().tool({
+  name: "greet",
+  inputSchema: { name: z.string() },
+  async execute(ctx, input) {
+    // input.name is typed as string
+    return ctx.json({ message: `Hello, ${input.name}` });
+  },
+});
+
+// Type-safe tool calls
+const response = await g.handleToolCall({
+  name: "greet", // Only "greet" is valid
+  input: { name: "World" }, // input is typed correctly
+});
+
+// Response type is inferred
+const data = await response.json(); // { message: string }
+```
+
+</details>

package/gram-template-gram/node_modules/.bin/tsc

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsc" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsc" "$@"
+fi

package/gram-template-gram/node_modules/.bin/tsserver

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsserver" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsserver" "$@"
+fi

package/gram-template-gram/package.json

@@ -0,0 +1,35 @@
+{
+  "type": "module",
+  "name": "gram-template-gram",
+  "version": "0.0.0",
+  "author": "",
+  "description": "",
+  "private": true,
+  "keywords": [
+    "mcp",
+    "getgram.ai"
+  ],
+  "license": "ISC",
+  "main": "dist/functions.js",
+  "files": [
+    "src",
+    "dist"
+  ],
+  "engine": {
+    "node": ">=22.18.0"
+  },
+  "scripts": {
+    "lint": "tsc --noEmit",
+    "build": "node ./src/build.ts",
+    "prebuild": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@gram-ai/functions": "workspace:",
+    "zod": "^4"
+  },
+  "devDependencies": {
+    "typescript": "^5",
+    "@types/node": "22.x"
+  }
+}

package/gram-template-gram/src/build.ts

@@ -0,0 +1,14 @@
+import { buildFunctions } from "@gram-ai/functions/build";
+import { join } from "path";
+
+async function build() {
+  await buildFunctions({
+    outDir: "dist",
+    entrypoint: join(import.meta.dirname, "functions.ts"),
+    export: "default",
+  });
+}
+
+if (import.meta.main) {
+  await build();
+}

package/gram-template-gram/src/functions.ts

@@ -0,0 +1,13 @@
+import { Gram } from "@gram-ai/functions";
+import * as z from "zod/mini";
+
+const gram = new Gram().tool({
+  name: "greet",
+  description: "Greet someone special",
+  inputSchema: { name: z.string() },
+  async execute(ctx, input) {
+    return ctx.json({ message: `Hello, ${input.name}!` });
+  },
+});
+
+export default gram;

package/gram-template-gram/tsconfig.json

@@ -0,0 +1,36 @@
+{
+  "include": ["src"],
+  "exclude": ["node_modules"],
+  "compilerOptions": {
+    "noEmit": true,
+    "rewriteRelativeImportExtensions": true,
+
+    "module": "nodenext",
+    "target": "esnext",
+    "lib": ["esnext"],
+    "types": ["node"],
+    "resolveJsonModule": true,
+
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+
+    "noUncheckedIndexedAccess": true,
+
+    "noImplicitReturns": true,
+    "noImplicitOverride": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noPropertyAccessFromIndexSignature": true,
+
+    "strict": true,
+    "erasableSyntaxOnly": true,
+    "jsx": "react-jsx",
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true,
+    "noUncheckedSideEffectImports": true,
+    "moduleDetection": "force",
+    "skipLibCheck": true
+  }
+}

package/gram-template-mcp/.gitignore

@@ -0,0 +1,9 @@
+node_modules
+dist
+.env
+.DS_Store
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+*.tsbuildinfo

package/gram-template-mcp/node_modules/.bin/tsc

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsc" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsc" "$@"
+fi

package/gram-template-mcp/node_modules/.bin/tsserver

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/typescript@5.8.3/node_modules:/home/runner/work/gram/gram/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsserver" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsserver" "$@"
+fi

package/gram-template-mcp/package.json

@@ -0,0 +1,35 @@
+{
+  "type": "module",
+  "name": "gram-template-mcp",
+  "version": "0.0.0",
+  "author": "",
+  "description": "",
+  "private": true,
+  "keywords": [
+    "mcp",
+    "getgram.ai"
+  ],
+  "license": "ISC",
+  "main": "dist/functions.js",
+  "files": [
+    "src",
+    "dist"
+  ],
+  "engine": {
+    "node": ">=22.18.0"
+  },
+  "scripts": {
+    "build": "node ./src/build.ts",
+    "prebuild": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@gram-ai/functions": "workspace:",
+    "@modelcontextprotocol/sdk": "^1.19.1",
+    "zod": "^3"
+  },
+  "devDependencies": {
+    "typescript": "^5",
+    "@types/node": "22.x"
+  }
+}

package/gram-template-mcp/src/build.ts

@@ -0,0 +1,14 @@
+import { buildMCPServer } from "@gram-ai/functions/build";
+
+async function build() {
+  await buildMCPServer({
+    outDir: "dist",
+    functionEntrypoint: "./src/functions.ts",
+    serverExport: "server",
+    serverEntrypoint: "./src/mcp.ts",
+  });
+}
+
+if (import.meta.main) {
+  await build();
+}

package/gram-template-mcp/src/functions.ts

@@ -0,0 +1,28 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
+import { server } from "./mcp.js";
+
+const [serverTransport, clientTransport] = InMemoryTransport.createLinkedPair();
+
+await server.connect(serverTransport);
+
+const client = new Client({ name: "gram-functions", version: "0.0.0" });
+await client.connect(clientTransport);
+
+export async function handleToolCall(call: {
+  name: string;
+  input?: Record<string, unknown>;
+  _meta?: Record<string, unknown>;
+}): Promise<Response> {
+  const response = await client.callTool({
+    name: call.name,
+    arguments: call.input,
+    _meta: call._meta,
+  });
+
+  const body = JSON.stringify(response);
+  return new Response(body, {
+    status: 200,
+    headers: { "Content-Type": "application/json; mcp=tools_call" },
+  });
+}

package/gram-template-mcp/src/mcp.ts

@@ -0,0 +1,22 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+
+export const server = new McpServer({
+  name: "demo-server",
+  version: "1.0.0",
+});
+
+server.registerTool(
+  "add",
+  {
+    title: "Addition Tool",
+    description: "Add two numbers",
+    inputSchema: { a: z.number(), b: z.number() },
+  },
+  async ({ a, b }) => {
+    const output = { result: a + b };
+    return {
+      content: [{ type: "text", text: JSON.stringify(output) }],
+    };
+  },
+);

package/gram-template-mcp/tsconfig.json

@@ -0,0 +1,36 @@
+{
+  "include": ["src"],
+  "exclude": ["node_modules"],
+  "compilerOptions": {
+    "noEmit": true,
+    "rewriteRelativeImportExtensions": true,
+
+    "module": "nodenext",
+    "target": "esnext",
+    "lib": ["esnext"],
+    "types": ["node"],
+    "resolveJsonModule": true,
+
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+
+    "noUncheckedIndexedAccess": true,
+
+    "noImplicitReturns": true,
+    "noImplicitOverride": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noPropertyAccessFromIndexSignature": true,
+
+    "strict": true,
+    "erasableSyntaxOnly": true,
+    "jsx": "react-jsx",
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true,
+    "noUncheckedSideEffectImports": true,
+    "moduleDetection": "force",
+    "skipLibCheck": true
+  }
+}

package/package.json

@@ -1,18 +1,46 @@
 {
+  "type": "module",
   "name": "@gram-ai/create-function",
-  "version": "0.0.0-empty",
-  "description": "",
-  "main": "index.js",
+  "version": "0.1.0",
+  "description": "Build AI tools and deploy them to getgram.ai",
+  "keywords": [],
+  "homepage": "https://github.com/speakeasy-api/gram",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/speakeasy-api/gram.git",
+    "directory": "ts-framework/create-function"
+  },
+  "author": "Georges Haidar <georges@speakeasyapi.dev>",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "bin": {
+    "create-function": "dist/main.js"
+  },
+  "engines": {
+    "node": ">=22.18.0"
+  },
   "publishConfig": {
     "access": "public"
   },
   "files": [
-    "index.js"
+    "src",
+    "dist",
+    "gram-template-*/**"
   ],
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+  "dependencies": {
+    "@bomb.sh/args": "^0.3.1",
+    "@clack/prompts": "^1.0.0-alpha.6",
+    "zx": "8.8.4-lite"
   },
-  "keywords": [],
-  "author": "",
-  "license": "ISC"
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.19.1",
+    "@types/node": "22.x",
+    "prettier": "^3.6.2",
+    "typescript": "5.9.2",
+    "zod": "^3.25.76",
+    "@gram-ai/functions": "^0.1.0"
+  },
+  "scripts": {
+    "build": "tsc --noEmit false"
+  }
 }

package/src/main.ts

@@ -0,0 +1,189 @@
+import { existsSync } from "node:fs";
+import fs from "node:fs/promises";
+import { join, resolve } from "node:path";
+import process from "node:process";
+import { $ } from "zx";
+import { isCancel, log, taskLog } from "@clack/prompts";
+import { parse } from "@bomb.sh/args";
+import pkg from "../package.json" with { type: "json" };
+
+import {
+  confirmOrClack,
+  selectOrClack,
+  textOrClack,
+  yn,
+} from "./prompts/helpers.ts";
+
+const packageNameRE = /^(@?[a-z0-9-_]+\/)?[a-z0-9-_]+$/;
+
+const knownPackageManagers = new Set(["npm", "yarn", "pnpm", "bun", "deno"]);
+
+async function init(argv: string[]): Promise<void> {
+  let packageManager = "npm";
+  let detectedPM = process.env["npm_config_user_agent"]?.split("/")[0] || "";
+  if (knownPackageManagers.has(detectedPM)) {
+    packageManager = detectedPM;
+  }
+
+  const args = parse(argv, {
+    alias: { y: "yes" },
+    string: ["template", "name", "dir", "git", "install"],
+    boolean: ["yes"],
+  });
+
+  const template = await selectOrClack<string>({
+    message: "Pick a framework",
+    options: [
+      {
+        value: "gram",
+        label: "Gram",
+        hint: "Simple framework focused on getting you up and runnning with minimal code.",
+      },
+      {
+        value: "mcp",
+        label: "MCP",
+        hint: "Use the official @modelcontextprotocol/sdk package to build an MCP server and deploy it to Gram.",
+      },
+    ],
+  })(args.template);
+  if (isCancel(template)) {
+    log.info("Operation cancelled.");
+    return;
+  }
+
+  const nameArg = args.name?.trim();
+  const name = await textOrClack({
+    message: "What do you want to call your project?",
+    defaultValue: "gram-mcp-server",
+    validate: (value) => {
+      if (packageNameRE.test(value || "")) {
+        return undefined;
+      }
+      return [
+        "Package names can be scoped or unscoped and must only contain alphanumeric characters, dashes and underscores.",
+        "Examples:",
+        "my-mcp-server",
+        "@fancy-org/mcp-server",
+      ].join(" ");
+    },
+  })(nameArg);
+  if (isCancel(name)) {
+    log.info("Operation cancelled.");
+    return;
+  }
+
+  const rootDir = name.split("/").pop()?.trim() || "gram-func";
+  const dirArg = args.dir?.trim();
+  let dir = await textOrClack({
+    message: "Where do you want to create it?",
+    initialValue: rootDir,
+    defaultValue: rootDir,
+    validate: (value) => {
+      const trimmed = value?.trim() || "";
+      if (trimmed.length === 0) {
+        return "Directory name cannot be empty.";
+      }
+
+      if (existsSync(trimmed)) {
+        return `Directory ${trimmed} already exists. Please choose a different name.`;
+      }
+
+      return undefined;
+    },
+  })(dirArg);
+  if (isCancel(dir)) {
+    log.info("Operation cancelled.");
+    return;
+  }
+  dir = dir.trim();
+
+  const initGit = await confirmOrClack({
+    message: "Initialize a git repository?",
+  })(args.yes || yn(args.git ?? false));
+  if (isCancel(initGit)) {
+    log.info("Operation cancelled.");
+    return;
+  }
+
+  const installDeps = await confirmOrClack({
+    message: `Install dependencies with ${packageManager}?`,
+  })(args.yes || yn(args.install ?? false));
+  if (isCancel(installDeps)) {
+    log.info("Operation cancelled.");
+    return;
+  }
+
+  const tlog = taskLog({
+    title: "Setting up project",
+  });
+
+  tlog.message("Scaffolding");
+  const dirname = import.meta.dirname;
+  const templateDir = resolve(join(dirname, "..", `gram-template-${template}`));
+  await fs.cp(templateDir, dir, {
+    recursive: true,
+    filter: (src) =>
+      !src.includes("node_modules") &&
+      !src.includes(".git") &&
+      !src.includes("dist"),
+  });
+
+  let gramFuncsVersion = pkg.devDependencies["@gram-ai/functions"];
+  if (gramFuncsVersion == null || gramFuncsVersion.startsWith("workspace:")) {
+    // This templating package and `@gram-ai/functions` are versioned in
+    // lockstep so we can just use the matching version.
+    gramFuncsVersion = `^${pkg.version}`;
+  }
+  if (
+    yn(process.env["GRAM_DEV"]) &&
+    existsSync(resolve(dirname, "..", "..", "functions"))
+  ) {
+    // For local development, use the local version of `@gram-ai/functions`
+    // if it exists.
+    const localPkgPath = resolve(dirname, "..", "..", "functions");
+    gramFuncsVersion = `file:${localPkgPath}`;
+    tlog.message(`Using local @gram-ai/functions from ${localPkgPath}`);
+  }
+
+  tlog.message("Updating package.json");
+  const pkgPath = await fs.readFile(join(dir, "package.json"), "utf-8");
+  const dstPkg = JSON.parse(pkgPath);
+  dstPkg.name = name;
+  const deps = dstPkg.dependencies;
+  if (deps?.["@gram-ai/functions"] != null) {
+    deps["@gram-ai/functions"] = gramFuncsVersion;
+  }
+
+  await fs.writeFile(
+    join(dir, "package.json"),
+    JSON.stringify(dstPkg, null, 2),
+  );
+
+  const contributingPath = join(dir, "CONTRIBUTING.md");
+  if (existsSync(contributingPath)) {
+    tlog.message("Creating symlinks for CONTRIBUTING.md");
+    await fs.symlink("CONTRIBUTING.md", join(dir, "AGENTS.md"));
+    await fs.symlink("CONTRIBUTING.md", join(dir, "CLAUDE.md"));
+  }
+
+  if (initGit) {
+    tlog.message("Initializing git repository");
+    await $`git init ${dir}`;
+  }
+
+  if (installDeps) {
+    tlog.message(`Installing dependencies with ${packageManager}`);
+    await $`cd ${dir} && ${packageManager} install`;
+  }
+
+  tlog.success(
+    `All done! Run \`cd ${dir} && ${packageManager} run build\` to build your first Gram Function.`,
+  );
+}
+
+try {
+  await init(process.argv);
+} catch (err) {
+  log.error(`Unexpected error: ${err}`);
+  process.exit(1);
+}

package/src/prompts/helpers.ts

@@ -0,0 +1,33 @@
+import {
+  confirm,
+  select,
+  text,
+  type ConfirmOptions,
+  type SelectOptions,
+  type TextOptions,
+} from "@clack/prompts";
+
+const y = new Set(["y", "yes", "true", "t", "1"]);
+export function yn(value: boolean | string | undefined): boolean {
+  if (value == null) return false;
+  if (typeof value === "boolean") return value;
+  return y.has(value.toLowerCase());
+}
+
+export function textOrClack(
+  options: TextOptions,
+): (value: string | undefined) => Promise<string | symbol> {
+  return async (value: string | undefined) => value || text(options);
+}
+
+export function selectOrClack<T>(
+  options: SelectOptions<T>,
+): (value: T | undefined) => Promise<T | symbol> {
+  return async (value: T | undefined) => value || select(options);
+}
+
+export function confirmOrClack(
+  options: ConfirmOptions,
+): (value: boolean | undefined) => Promise<boolean | symbol> {
+  return async (value: boolean | undefined) => value || confirm(options);
+}

package/index.js

@@ -1,3 +0,0 @@
-export function greet() {
-  return "Hello, World!";
-}