Initial commit

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: sigmachirality

.agents/skills/speakeasy-context/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: speakeasy-context
+description: "Speakeasy workflow: run 'agent context' FIRST, do task, run 'agent feedback' LAST. Triggers on speakeasy, SDK, OpenAPI."
+license: Apache-2.0
+---
+
+# speakeasy-context
+
+## Rule
+
+Before any Speakeasy task: **run `speakeasy agent context`**. Prefer CLI output over web/docs.
+
+## Commands
+
+```bash
+speakeasy agent context          # Get current CLI capabilities
+speakeasy agent feedback "<msg>" # Report issues or suggestions
+speakeasy <command> --help       # Command-specific help
+```
+
+## Workflow
+
+1. `speakeasy agent context`
+2. Do the task using Speakeasy CLI
+3. `speakeasy agent feedback "<msg>"` — **always provide feedback** after completing a task (what worked, what was confusing, suggestions)
+
+## Don'ts
+
+- Don't use web search as source of truth
+- Don't guess syntax; use `context` or `--help`
+- Don't skip `context` at session start

.devcontainer/README.md

@@ -0,0 +1,30 @@
+
+> **Remember to shutdown a GitHub Codespace when it is not in use!**
+
+# Dev Containers Quick Start
+
+The default location for usage snippets is the `samples` directory.
+
+## Running a Usage Sample
+
+A sample usage example has been provided in a `root.ts` file. As you work with the SDK, it's expected that you will modify these samples to fit your needs. To execute this particular snippet, use the command below.
+
+```
+ts-node root.ts
+```
+
+## Generating Additional Usage Samples
+
+The speakeasy CLI allows you to generate more usage snippets. Here's how:
+
+- To generate a sample for a specific operation by providing an operation ID, use:
+
+```
+speakeasy generate usage -s .speakeasy/out.openapi.yaml -l typescript -i {INPUT_OPERATION_ID} -o ./samples
+```
+
+- To generate samples for an entire namespace (like a tag or group name), use:
+
+```
+speakeasy generate usage -s .speakeasy/out.openapi.yaml -l typescript -n {INPUT_TAG_NAME} -o ./samples
+```

.devcontainer/devcontainer.json

@@ -0,0 +1,45 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/images/tree/main/src/typescript-node
+{
+    "name": "TypeScript",
+    "image": "mcr.microsoft.com/devcontainers/typescript-node:1-20-bullseye",
+    // Features to add to the dev container. More info: https://containers.dev/features.
+    // "features": {},
+    // Use 'forwardPorts' to make a list of ports inside the container available locally.
+    // "forwardPorts": [],
+    // Use 'postCreateCommand' to run commands after the container is created.
+    "postCreateCommand": "sudo chmod +x ./.devcontainer/setup.sh && ./.devcontainer/setup.sh",
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "ms-vscode.vscode-typescript-tslint-plugin",
+                "esbenp.prettier-vscode",
+                "github.vscode-pull-request-github"
+            ],
+            "settings": {
+                "files.eol": "\n",
+                "editor.formatOnSave": true,
+                "typescript.tsc.autoDetect": "on",
+                "typescript.updateImportsOnFileMove.enabled": "always",
+                "typescript.preferences.importModuleSpecifier": "relative",
+                "[typescript]": {
+                    "editor.codeActionsOnSave": {
+                        "source.organizeImports": true
+                    }
+                },
+                "[typescriptreact]": {
+                    "editor.codeActionsOnSave": {
+                        "source.organizeImports": true
+                    }
+                }
+            }
+        },
+        "codespaces": {
+            "openFiles": [
+                ".devcontainer/README.md"
+            ]
+        }
+    }
+    // Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+    // "remoteUser": "root"
+}

.devcontainer/setup.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+
+# Install the speakeasy CLI
+curl -fsSL https://raw.githubusercontent.com/speakeasy-api/speakeasy/main/install.sh | sh
+
+# Setup samples directory
+rmdir samples || true
+mkdir samples
+
+npm install --ignore-scripts
+npm install -g ts-node --ignore-scripts
+npm link
+npm link @sfcompute/sdk
+TS_CONFIG_CONTENT=$(cat <<EOL
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "openapi": ["../src/index"],
+      "openapi/*": ["../src/*"]
+    }
+  },
+  "include": ["./**/*.ts"]
+}
+EOL
+)
+echo "$TS_CONFIG_CONTENT" > samples/tsconfig.json
+
+# Generate starter usage sample with speakeasy
+speakeasy generate usage -s .speakeasy/out.openapi.yaml -l typescript -o samples/root.ts

.gitattributes

@@ -0,0 +1,2 @@
+# This allows generated code to be indexed correctly
+*.ts linguist-generated=false

.github/copilot/skills/speakeasy-context

@@ -0,0 +1 @@
+../../../.agents/skills/speakeasy-context

.gitignore

@@ -0,0 +1,30 @@
+/models
+/models/errors
+/types
+/node_modules
+/examples/node_modules
+/lib
+/sdk
+/funcs
+/react-query
+/mcp-server
+/hooks
+/index.*
+/core.*
+/bin
+/cjs
+/esm
+/dist
+/.tsbuildinfo
+/.eslintcache
+/.tshy
+/.tshy-*
+/__tests__
+.DS_Store
+**/.speakeasy/temp/
+**/.speakeasy/logs/
+.DS_Store
+/.speakeasy/reports
+.env
+.env.local
+.env.*.local

.npmignore

@@ -0,0 +1,15 @@
+**/*
+!/FUNCTIONS.md
+!/RUNTIMES.md
+!/REACT_QUERY.md
+!/**/*.ts
+!/**/*.js
+!/**/*.mjs
+!/**/*.json
+!/**/*.map
+
+/eslint.config.mjs
+/cjs
+/.tshy
+/.tshy-*
+/__tests__