@afps-spec/schema 1.0.0

package/README.md

@@ -0,0 +1,59 @@
+# AFPS JSON Schemas
+
+Machine-readable representation of the AFPS specification. The specification text ([spec.md](../spec.md)) is the normative source.
+
+## npm package
+
+This directory is published as `@afps/schema` on npm. Implementations can import the Zod schemas and extend them:
+
+```typescript
+import { flowManifestSchema } from "@afps/schema";
+
+const myFlowSchema = flowManifestSchema.extend({
+  "x-custom-field": z.string().optional(),
+});
+```
+
+## Versioned schemas
+
+Schemas are organized by major version:
+
+```
+schema/
+├── v1/                   ← AFPS v1.x schemas
+│   ├── flow.schema.json
+│   ├── skill.schema.json
+│   ├── tool.schema.json
+│   └── provider.schema.json
+├── src/
+│   ├── schemas.ts        ← Zod source (generates v1/)
+│   ├── generate.ts       ← Generation script
+│   └── index.ts          ← npm entry point
+└── package.json          ← @afps/schema
+```
+
+URLs follow the pattern `https://afps.appstrate.dev/schema/v1/<type>.schema.json`.
+
+## Regenerating
+
+After modifying the Zod source in `src/schemas.ts`:
+
+```sh
+cd schema && bun install && bun run generate
+```
+
+## Usage in manifests
+
+Reference a schema using `$schema` for editor validation:
+
+```json
+{
+  "$schema": "https://afps.appstrate.dev/schema/v1/flow.schema.json",
+  "schemaVersion": "1.0",
+  "name": "@scope/my-flow",
+  "version": "1.0.0",
+  "type": "flow"
+}
+```
+
+Implementations may extend these schemas with additional fields using the `x-` prefix convention (see spec §10).

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@afps-spec/schema",
+  "version": "1.0.0",
+  "type": "module",
+  "files": [
+    "src",
+    "v1"
+  ],
+  "exports": {
+    ".": "./src/index.ts",
+    "./v1/*": "./v1/*"
+  },
+  "scripts": {
+    "generate": "bun src/generate.ts"
+  },
+  "dependencies": {
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "bun-types": "latest"
+  }
+}

package/src/generate.ts

@@ -0,0 +1,80 @@
+/**
+ * Generate AFPS JSON Schema files from the Zod definitions.
+ *
+ * Change MAJOR to generate schemas for a different spec version.
+ *
+ * Usage: bun src/generate.ts  (from schema/)
+ */
+
+import { toJSONSchema } from "zod/v4/core";
+import { resolve, dirname } from "node:path";
+import { writeFile, mkdir } from "node:fs/promises";
+import { createSchemas } from "./schemas.ts";
+
+const MAJOR = 1;
+const VERSION_TAG = `v${MAJOR}`;
+const BASE_URL = "https://afps.appstrate.dev/schema";
+const OUTPUT_DIR = resolve(dirname(import.meta.filename!), "..", VERSION_TAG);
+
+const { flowManifestSchema, skillManifestSchema, toolManifestSchema, providerManifestSchema } =
+  createSchemas(MAJOR);
+
+const entries = [
+  {
+    filename: "flow.schema.json",
+    title: "AFPS Flow Manifest",
+    description:
+      "Manifest schema for AFPS flow packages. " +
+      "A flow declares dependencies, input/output/config schemas, a timeout hint, and provider configuration.",
+    schema: flowManifestSchema,
+  },
+  {
+    filename: "skill.schema.json",
+    title: "AFPS Skill Manifest",
+    description:
+      "Manifest schema for AFPS skill packages. " +
+      "A skill is a reusable prompt with optional frontmatter metadata.",
+    schema: skillManifestSchema,
+  },
+  {
+    filename: "tool.schema.json",
+    title: "AFPS Tool Manifest",
+    description:
+      "Manifest schema for AFPS tool packages. " +
+      "A tool declares a single callable capability with its interface and implementation source.",
+    schema: toolManifestSchema,
+  },
+  {
+    filename: "provider.schema.json",
+    title: "AFPS Provider Manifest",
+    description:
+      "Manifest schema for AFPS provider packages. " +
+      "A provider declares auth mode, OAuth endpoints, credential schema, and setup guide.",
+    schema: providerManifestSchema,
+  },
+];
+
+await mkdir(OUTPUT_DIR, { recursive: true });
+
+for (const entry of entries) {
+  const jsonSchema = toJSONSchema(entry.schema, {
+    unrepresentable: "any",
+    target: "draft-2020-12",
+  }) as Record<string, unknown>;
+
+  delete jsonSchema.$schema;
+
+  const final = {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    $id: `${BASE_URL}/${VERSION_TAG}/${entry.filename}`,
+    title: entry.title,
+    description: entry.description,
+    ...jsonSchema,
+  };
+
+  const filePath = resolve(OUTPUT_DIR, entry.filename);
+  await writeFile(filePath, JSON.stringify(final, null, 2) + "\n");
+  console.log(`  ✓ ${VERSION_TAG}/${entry.filename}`);
+}
+
+console.log(`\nGenerated ${entries.length} schemas in ${OUTPUT_DIR}`);

package/src/index.ts

@@ -0,0 +1,14 @@
+/**
+ * @afps/schema — AFPS Zod schemas for manifest validation.
+ *
+ * Default exports are AFPS v1 schemas. Use createSchemas(majorVersion)
+ * to generate schemas for a specific version.
+ */
+
+export {
+  createSchemas,
+  flowManifestSchema,
+  skillManifestSchema,
+  toolManifestSchema,
+  providerManifestSchema,
+} from "./schemas.ts";

package/src/schemas.ts

@@ -0,0 +1,197 @@
+/**
+ * AFPS — Zod schemas for the four package types.
+ *
+ * These schemas define ONLY the fields in the AFPS specification.
+ * No implementation-specific fields (x-* or otherwise) belong here.
+ *
+ * Schemas are parameterized by major version: the schemaVersion field
+ * is constrained to match (e.g., v1 schemas accept "1.0", "1.1", etc.)
+ *
+ * Source of truth: ../spec.md (§2–§7)
+ */
+
+import { z } from "zod";
+
+// ─────────────────────────────────────────────
+// Shared patterns and primitives
+// ─────────────────────────────────────────────
+
+const SLUG_PATTERN = "[a-z0-9]([a-z0-9-]*[a-z0-9])?";
+const SCOPED_NAME_REGEX = new RegExp(`^@${SLUG_PATTERN}\\/${SLUG_PATTERN}$`);
+
+const scopedName = z.string().regex(SCOPED_NAME_REGEX);
+const semverRange = z.string().min(1);
+
+// ─────────────────────────────────────────────
+// Schema system (§5)
+// ─────────────────────────────────────────────
+
+const fieldTypeEnum = z.enum(["string", "number", "boolean", "array", "object", "file"]);
+
+const schemaProperty = z.looseObject({
+  type: fieldTypeEnum,
+  description: z.string().optional(),
+  default: z.unknown().optional(),
+  enum: z.array(z.unknown()).optional(),
+  format: z.string().optional(),
+  placeholder: z.string().optional(),
+  accept: z.string().optional(),
+  maxSize: z.number().positive().optional(),
+  multiple: z.boolean().optional(),
+  maxFiles: z.number().positive().optional(),
+});
+
+const schemaObject = z.looseObject({
+  type: z.literal("object"),
+  properties: z.record(z.string(), schemaProperty),
+  required: z.array(z.string()).optional(),
+  propertyOrder: z.array(z.string()).optional(),
+});
+
+const schemaWrapper = z.object({
+  schema: schemaObject,
+});
+
+// ─────────────────────────────────────────────
+// Dependencies (§4)
+// ─────────────────────────────────────────────
+
+const dependenciesSchema = z
+  .looseObject({
+    skills: z.record(scopedName, semverRange).optional(),
+    tools: z.record(scopedName, semverRange).optional(),
+    providers: z.record(scopedName, semverRange).optional(),
+  })
+  .optional();
+
+// ─────────────────────────────────────────────
+// Provider configuration (§4.4)
+// ─────────────────────────────────────────────
+
+const providerConfiguration = z.looseObject({
+  scopes: z.array(z.string()).optional(),
+  connectionMode: z.enum(["user", "admin"]).optional(),
+});
+
+// ─────────────────────────────────────────────
+// Tool interface (§3.4)
+// ─────────────────────────────────────────────
+
+const toolInterface = z.object({
+  name: z.string().min(1),
+  description: z.string().min(1),
+  inputSchema: z.looseObject({}),
+});
+
+// ─────────────────────────────────────────────
+// Auth and provider internals (§3.5 + §7)
+// ─────────────────────────────────────────────
+
+const authModeEnum = z.enum(["oauth2", "oauth1", "api_key", "basic", "custom"]);
+
+const providerDefinition = z.looseObject({
+  authMode: authModeEnum,
+  authorizationUrl: z.string().optional(),
+  tokenUrl: z.string().optional(),
+  refreshUrl: z.string().optional(),
+  defaultScopes: z.array(z.string()).optional(),
+  scopeSeparator: z.string().optional(),
+  pkceEnabled: z.boolean().optional(),
+  tokenAuthMethod: z.string().optional(),
+  authorizationParams: z.record(z.string(), z.unknown()).optional(),
+  tokenParams: z.record(z.string(), z.unknown()).optional(),
+  requestTokenUrl: z.string().optional(),
+  accessTokenUrl: z.string().optional(),
+  credentialSchema: z.record(z.string(), z.unknown()).optional(),
+  credentialFieldName: z.string().optional(),
+  credentialHeaderName: z.string().optional(),
+  credentialHeaderPrefix: z.string().optional(),
+  authorizedUris: z.array(z.string()).optional(),
+  allowAllUris: z.boolean().optional(),
+  availableScopes: z.array(z.unknown()).optional(),
+});
+
+const setupGuide = z
+  .object({
+    callbackUrlHint: z.string().optional(),
+    steps: z
+      .array(
+        z.looseObject({
+          label: z.string(),
+          url: z.string().optional(),
+        }),
+      )
+      .optional(),
+  })
+  .optional();
+
+// ─────────────────────────────────────────────
+// Schema factory — parameterized by major version
+// ─────────────────────────────────────────────
+
+export function createSchemas(majorVersion: number) {
+  const schemaVersionField = z
+    .string()
+    .regex(new RegExp(`^${majorVersion}\\.(0|[1-9]\\d*)$`));
+
+  const commonFields = {
+    name: scopedName,
+    version: z.string().min(1),
+    type: z.enum(["flow", "skill", "tool", "provider"]),
+    displayName: z.string().optional(),
+    description: z.string().optional(),
+    keywords: z.array(z.string()).optional(),
+    license: z.string().optional(),
+    repository: z.string().optional(),
+    schemaVersion: schemaVersionField.optional(),
+    dependencies: dependenciesSchema,
+  };
+
+  const flowManifestSchema = z.looseObject({
+    ...commonFields,
+    type: z.literal("flow"),
+    schemaVersion: schemaVersionField,
+    displayName: z.string().min(1),
+    author: z.string(),
+    providersConfiguration: z.record(scopedName, providerConfiguration).optional(),
+    input: schemaWrapper.optional(),
+    output: schemaWrapper.optional(),
+    config: schemaWrapper.optional(),
+    timeout: z.number().positive().optional(),
+  });
+
+  const skillManifestSchema = z.looseObject({
+    ...commonFields,
+    type: z.literal("skill"),
+  });
+
+  const toolManifestSchema = z.looseObject({
+    ...commonFields,
+    type: z.literal("tool"),
+    entrypoint: z.string().min(1),
+    tool: toolInterface,
+  });
+
+  const providerManifestSchema = z.looseObject({
+    ...commonFields,
+    type: z.literal("provider"),
+    iconUrl: z.string().optional(),
+    categories: z.array(z.string()).optional(),
+    docsUrl: z.string().optional(),
+    definition: providerDefinition,
+    setupGuide: setupGuide,
+  });
+
+  return { flowManifestSchema, skillManifestSchema, toolManifestSchema, providerManifestSchema };
+}
+
+// ─────────────────────────────────────────────
+// Default exports — AFPS v1
+// ─────────────────────────────────────────────
+
+const v1 = createSchemas(1);
+
+export const flowManifestSchema = v1.flowManifestSchema;
+export const skillManifestSchema = v1.skillManifestSchema;
+export const toolManifestSchema = v1.toolManifestSchema;
+export const providerManifestSchema = v1.providerManifestSchema;

package/v1/flow.schema.json

@@ -0,0 +1,392 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://afps.appstrate.dev/schema/v1/flow.schema.json",
+  "title": "AFPS Flow Manifest",
+  "description": "Manifest schema for AFPS flow packages. A flow declares dependencies, input/output/config schemas, a timeout hint, and provider configuration.",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^@[a-z0-9]([a-z0-9-]*[a-z0-9])?\\/[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
+    },
+    "version": {
+      "type": "string",
+      "minLength": 1
+    },
+    "type": {
+      "type": "string",
+      "const": "flow"
+    },
+    "displayName": {
+      "type": "string",
+      "minLength": 1
+    },
+    "description": {
+      "type": "string"
+    },
+    "keywords": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "license": {
+      "type": "string"
+    },
+    "repository": {
+      "type": "string"
+    },
+    "schemaVersion": {
+      "type": "string",
+      "pattern": "^1\\.(0|[1-9]\\d*)$"
+    },
+    "dependencies": {
+      "type": "object",
+      "properties": {
+        "skills": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "pattern": "^@[a-z0-9]([a-z0-9-]*[a-z0-9])?\\/[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
+          },
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "tools": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "pattern": "^@[a-z0-9]([a-z0-9-]*[a-z0-9])?\\/[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
+          },
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "providers": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "pattern": "^@[a-z0-9]([a-z0-9-]*[a-z0-9])?\\/[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
+          },
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "additionalProperties": {}
+    },
+    "author": {
+      "type": "string"
+    },
+    "providersConfiguration": {
+      "type": "object",
+      "propertyNames": {
+        "type": "string",
+        "pattern": "^@[a-z0-9]([a-z0-9-]*[a-z0-9])?\\/[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
+      },
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "scopes": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "connectionMode": {
+            "type": "string",
+            "enum": [
+              "user",
+              "admin"
+            ]
+          }
+        },
+        "additionalProperties": {}
+      }
+    },
+    "input": {
+      "type": "object",
+      "properties": {
+        "schema": {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "object"
+            },
+            "properties": {
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "string",
+                      "number",
+                      "boolean",
+                      "array",
+                      "object",
+                      "file"
+                    ]
+                  },
+                  "description": {
+                    "type": "string"
+                  },
+                  "default": {},
+                  "enum": {
+                    "type": "array",
+                    "items": {}
+                  },
+                  "format": {
+                    "type": "string"
+                  },
+                  "placeholder": {
+                    "type": "string"
+                  },
+                  "accept": {
+                    "type": "string"
+                  },
+                  "maxSize": {
+                    "type": "number",
+                    "exclusiveMinimum": 0
+                  },
+                  "multiple": {
+                    "type": "boolean"
+                  },
+                  "maxFiles": {
+                    "type": "number",
+                    "exclusiveMinimum": 0
+                  }
+                },
+                "required": [
+                  "type"
+                ],
+                "additionalProperties": {}
+              }
+            },
+            "required": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "propertyOrder": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "required": [
+            "type",
+            "properties"
+          ],
+          "additionalProperties": {}
+        }
+      },
+      "required": [
+        "schema"
+      ],
+      "additionalProperties": false
+    },
+    "output": {
+      "type": "object",
+      "properties": {
+        "schema": {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "object"
+            },
+            "properties": {
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "string",
+                      "number",
+                      "boolean",
+                      "array",
+                      "object",
+                      "file"
+                    ]
+                  },
+                  "description": {
+                    "type": "string"
+                  },
+                  "default": {},
+                  "enum": {
+                    "type": "array",
+                    "items": {}
+                  },
+                  "format": {
+                    "type": "string"
+                  },
+                  "placeholder": {
+                    "type": "string"
+                  },
+                  "accept": {
+                    "type": "string"
+                  },
+                  "maxSize": {
+                    "type": "number",
+                    "exclusiveMinimum": 0
+                  },
+                  "multiple": {
+                    "type": "boolean"
+                  },
+                  "maxFiles": {
+                    "type": "number",
+                    "exclusiveMinimum": 0
+                  }
+                },
+                "required": [
+                  "type"
+                ],
+                "additionalProperties": {}
+              }
+            },
+            "required": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "propertyOrder": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "required": [
+            "type",
+            "properties"
+          ],
+          "additionalProperties": {}
+        }
+      },
+      "required": [
+        "schema"
+      ],
+      "additionalProperties": false
+    },
+    "config": {
+      "type": "object",
+      "properties": {
+        "schema": {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "object"
+            },
+            "properties": {
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "string",
+                      "number",
+                      "boolean",
+                      "array",
+                      "object",
+                      "file"
+                    ]
+                  },
+                  "description": {
+                    "type": "string"
+                  },
+                  "default": {},
+                  "enum": {
+                    "type": "array",
+                    "items": {}
+                  },
+                  "format": {
+                    "type": "string"
+                  },
+                  "placeholder": {
+                    "type": "string"
+                  },
+                  "accept": {
+                    "type": "string"
+                  },
+                  "maxSize": {
+                    "type": "number",
+                    "exclusiveMinimum": 0
+                  },
+                  "multiple": {
+                    "type": "boolean"
+                  },
+                  "maxFiles": {
+                    "type": "number",
+                    "exclusiveMinimum": 0
+                  }
+                },
+                "required": [
+                  "type"
+                ],
+                "additionalProperties": {}
+              }
+            },
+            "required": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "propertyOrder": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "required": [
+            "type",
+            "properties"
+          ],
+          "additionalProperties": {}
+        }
+      },
+      "required": [
+        "schema"
+      ],
+      "additionalProperties": false
+    },
+    "timeout": {
+      "type": "number",
+      "exclusiveMinimum": 0
+    }
+  },
+  "required": [
+    "name",
+    "version",
+    "type",
+    "displayName",
+    "schemaVersion",
+    "author"
+  ],
+  "additionalProperties": {}
+}

package/v1/provider.schema.json

@@ -0,0 +1,220 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://afps.appstrate.dev/schema/v1/provider.schema.json",
+  "title": "AFPS Provider Manifest",
+  "description": "Manifest schema for AFPS provider packages. A provider declares auth mode, OAuth endpoints, credential schema, and setup guide.",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^@[a-z0-9]([a-z0-9-]*[a-z0-9])?\\/[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
+    },
+    "version": {
+      "type": "string",
+      "minLength": 1
+    },
+    "type": {
+      "type": "string",
+      "const": "provider"
+    },
+    "displayName": {
+      "type": "string"
+    },
+    "description": {
+      "type": "string"
+    },
+    "keywords": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "license": {
+      "type": "string"
+    },
+    "repository": {
+      "type": "string"
+    },
+    "schemaVersion": {
+      "type": "string",
+      "pattern": "^1\\.(0|[1-9]\\d*)$"
+    },
+    "dependencies": {
+      "type": "object",
+      "properties": {
+        "skills": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "pattern": "^@[a-z0-9]([a-z0-9-]*[a-z0-9])?\\/[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
+          },
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "tools": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "pattern": "^@[a-z0-9]([a-z0-9-]*[a-z0-9])?\\/[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
+          },
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "providers": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "pattern": "^@[a-z0-9]([a-z0-9-]*[a-z0-9])?\\/[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
+          },
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "additionalProperties": {}
+    },
+    "iconUrl": {
+      "type": "string"
+    },
+    "categories": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "docsUrl": {
+      "type": "string"
+    },
+    "definition": {
+      "type": "object",
+      "properties": {
+        "authMode": {
+          "type": "string",
+          "enum": [
+            "oauth2",
+            "oauth1",
+            "api_key",
+            "basic",
+            "custom"
+          ]
+        },
+        "authorizationUrl": {
+          "type": "string"
+        },
+        "tokenUrl": {
+          "type": "string"
+        },
+        "refreshUrl": {
+          "type": "string"
+        },
+        "defaultScopes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "scopeSeparator": {
+          "type": "string"
+        },
+        "pkceEnabled": {
+          "type": "boolean"
+        },
+        "tokenAuthMethod": {
+          "type": "string"
+        },
+        "authorizationParams": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        },
+        "tokenParams": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        },
+        "requestTokenUrl": {
+          "type": "string"
+        },
+        "accessTokenUrl": {
+          "type": "string"
+        },
+        "credentialSchema": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        },
+        "credentialFieldName": {
+          "type": "string"
+        },
+        "credentialHeaderName": {
+          "type": "string"
+        },
+        "credentialHeaderPrefix": {
+          "type": "string"
+        },
+        "authorizedUris": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "allowAllUris": {
+          "type": "boolean"
+        },
+        "availableScopes": {
+          "type": "array",
+          "items": {}
+        }
+      },
+      "required": [
+        "authMode"
+      ],
+      "additionalProperties": {}
+    },
+    "setupGuide": {
+      "type": "object",
+      "properties": {
+        "callbackUrlHint": {
+          "type": "string"
+        },
+        "steps": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "label": {
+                "type": "string"
+              },
+              "url": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "label"
+            ],
+            "additionalProperties": {}
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "name",
+    "version",
+    "type",
+    "definition"
+  ],
+  "additionalProperties": {}
+}

package/v1/skill.schema.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://afps.appstrate.dev/schema/v1/skill.schema.json",
+  "title": "AFPS Skill Manifest",
+  "description": "Manifest schema for AFPS skill packages. A skill is a reusable prompt with optional frontmatter metadata.",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^@[a-z0-9]([a-z0-9-]*[a-z0-9])?\\/[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
+    },
+    "version": {
+      "type": "string",
+      "minLength": 1
+    },
+    "type": {
+      "type": "string",
+      "const": "skill"
+    },
+    "displayName": {
+      "type": "string"
+    },
+    "description": {
+      "type": "string"
+    },
+    "keywords": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "license": {
+      "type": "string"
+    },
+    "repository": {
+      "type": "string"
+    },
+    "schemaVersion": {
+      "type": "string",
+      "pattern": "^1\\.(0|[1-9]\\d*)$"
+    },
+    "dependencies": {
+      "type": "object",
+      "properties": {
+        "skills": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "pattern": "^@[a-z0-9]([a-z0-9-]*[a-z0-9])?\\/[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
+          },
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "tools": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "pattern": "^@[a-z0-9]([a-z0-9-]*[a-z0-9])?\\/[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
+          },
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "providers": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "pattern": "^@[a-z0-9]([a-z0-9-]*[a-z0-9])?\\/[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
+          },
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "additionalProperties": {}
+    }
+  },
+  "required": [
+    "name",
+    "version",
+    "type"
+  ],
+  "additionalProperties": {}
+}

package/v1/tool.schema.json

@@ -0,0 +1,118 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://afps.appstrate.dev/schema/v1/tool.schema.json",
+  "title": "AFPS Tool Manifest",
+  "description": "Manifest schema for AFPS tool packages. A tool declares a single callable capability with its interface and implementation source.",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^@[a-z0-9]([a-z0-9-]*[a-z0-9])?\\/[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
+    },
+    "version": {
+      "type": "string",
+      "minLength": 1
+    },
+    "type": {
+      "type": "string",
+      "const": "tool"
+    },
+    "displayName": {
+      "type": "string"
+    },
+    "description": {
+      "type": "string"
+    },
+    "keywords": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "license": {
+      "type": "string"
+    },
+    "repository": {
+      "type": "string"
+    },
+    "schemaVersion": {
+      "type": "string",
+      "pattern": "^1\\.(0|[1-9]\\d*)$"
+    },
+    "dependencies": {
+      "type": "object",
+      "properties": {
+        "skills": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "pattern": "^@[a-z0-9]([a-z0-9-]*[a-z0-9])?\\/[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
+          },
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "tools": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "pattern": "^@[a-z0-9]([a-z0-9-]*[a-z0-9])?\\/[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
+          },
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "providers": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "pattern": "^@[a-z0-9]([a-z0-9-]*[a-z0-9])?\\/[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
+          },
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "additionalProperties": {}
+    },
+    "entrypoint": {
+      "type": "string",
+      "minLength": 1
+    },
+    "tool": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "inputSchema": {
+          "type": "object",
+          "properties": {},
+          "additionalProperties": {}
+        }
+      },
+      "required": [
+        "name",
+        "description",
+        "inputSchema"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "name",
+    "version",
+    "type",
+    "entrypoint",
+    "tool"
+  ],
+  "additionalProperties": {}
+}