@agent-native/core 0.59.0 → 0.60.0

package/dist/org/migrations.js.map

@@ -1 +1 @@
-{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/org/migrations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE;;;;;MAKH;KACH;IACD;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE;;;;;;;MAOH;KACH;IACD;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE;;;;;;;MAOH;KACH;IACD;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,wEAAwE;KAC9E;IACD;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,oEAAoE;KAC1E;IACD;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,gEAAgE;KACtE;IACD;QACE,kEAAkE;QAClE,mEAAmE;QACnE,oEAAoE;QACpE,8CAA8C;QAC9C,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,sFAAsF;KAC5F;CACF,CAAC","sourcesContent":["/**\n * Migration definitions for the org module. Versions are namespaced into a high\n * range (1000+) so they don't collide with template-owned migrations sharing\n * the same `_migrations` table.\n */\nexport const ORG_MIGRATIONS = [\n  {\n    version: 1001,\n    sql: `CREATE TABLE IF NOT EXISTS organizations (\n      id TEXT PRIMARY KEY,\n      name TEXT NOT NULL,\n      created_by TEXT NOT NULL,\n      created_at INTEGER NOT NULL\n    )`,\n  },\n  {\n    version: 1002,\n    sql: `CREATE TABLE IF NOT EXISTS org_members (\n      id TEXT PRIMARY KEY,\n      org_id TEXT NOT NULL,\n      email TEXT NOT NULL,\n      role TEXT NOT NULL,\n      joined_at INTEGER NOT NULL,\n      UNIQUE(org_id, email)\n    )`,\n  },\n  {\n    version: 1003,\n    sql: `CREATE TABLE IF NOT EXISTS org_invitations (\n      id TEXT PRIMARY KEY,\n      org_id TEXT NOT NULL,\n      email TEXT NOT NULL,\n      invited_by TEXT NOT NULL,\n      created_at INTEGER NOT NULL,\n      status TEXT NOT NULL\n    )`,\n  },\n  {\n    version: 1004,\n    sql: `ALTER TABLE organizations ADD COLUMN IF NOT EXISTS allowed_domain TEXT`,\n  },\n  {\n    version: 1005,\n    sql: `ALTER TABLE organizations ADD COLUMN IF NOT EXISTS a2a_secret TEXT`,\n  },\n  {\n    version: 1006,\n    sql: `ALTER TABLE org_invitations ADD COLUMN IF NOT EXISTS role TEXT`,\n  },\n  {\n    // Every authenticated request calls `getOrgContext` which queries\n    // `WHERE LOWER(m.email) = ?`. Without a supporting index this is a\n    // full table scan on every request. A LOWER(email) expression index\n    // lets the planner use an index seek instead.\n    version: 1007,\n    sql: `CREATE INDEX IF NOT EXISTS org_members_lower_email_idx ON org_members (LOWER(email))`,\n  },\n];\n"]}
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/org/migrations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE;;;;;MAKH;KACH;IACD;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE;;;;;;;MAOH;KACH;IACD;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE;;;;;;;MAOH;KACH;IACD;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,wEAAwE;KAC9E;IACD;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,oEAAoE;KAC1E;IACD;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,gEAAgE;KACtE;IACD;QACE,kEAAkE;QAClE,mEAAmE;QACnE,oEAAoE;QACpE,8CAA8C;QAC9C,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,sFAAsF;KAC5F;IACD;QACE,gEAAgE;QAChE,yEAAyE;QACzE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,4GAA4G;KAClH;CACF,CAAC","sourcesContent":["/**\n * Migration definitions for the org module. Versions are namespaced into a high\n * range (1000+) so they don't collide with template-owned migrations sharing\n * the same `_migrations` table.\n */\nexport const ORG_MIGRATIONS = [\n  {\n    version: 1001,\n    sql: `CREATE TABLE IF NOT EXISTS organizations (\n      id TEXT PRIMARY KEY,\n      name TEXT NOT NULL,\n      created_by TEXT NOT NULL,\n      created_at INTEGER NOT NULL\n    )`,\n  },\n  {\n    version: 1002,\n    sql: `CREATE TABLE IF NOT EXISTS org_members (\n      id TEXT PRIMARY KEY,\n      org_id TEXT NOT NULL,\n      email TEXT NOT NULL,\n      role TEXT NOT NULL,\n      joined_at INTEGER NOT NULL,\n      UNIQUE(org_id, email)\n    )`,\n  },\n  {\n    version: 1003,\n    sql: `CREATE TABLE IF NOT EXISTS org_invitations (\n      id TEXT PRIMARY KEY,\n      org_id TEXT NOT NULL,\n      email TEXT NOT NULL,\n      invited_by TEXT NOT NULL,\n      created_at INTEGER NOT NULL,\n      status TEXT NOT NULL\n    )`,\n  },\n  {\n    version: 1004,\n    sql: `ALTER TABLE organizations ADD COLUMN IF NOT EXISTS allowed_domain TEXT`,\n  },\n  {\n    version: 1005,\n    sql: `ALTER TABLE organizations ADD COLUMN IF NOT EXISTS a2a_secret TEXT`,\n  },\n  {\n    version: 1006,\n    sql: `ALTER TABLE org_invitations ADD COLUMN IF NOT EXISTS role TEXT`,\n  },\n  {\n    // Every authenticated request calls `getOrgContext` which queries\n    // `WHERE LOWER(m.email) = ?`. Without a supporting index this is a\n    // full table scan on every request. A LOWER(email) expression index\n    // lets the planner use an index seek instead.\n    version: 1007,\n    sql: `CREATE INDEX IF NOT EXISTS org_members_lower_email_idx ON org_members (LOWER(email))`,\n  },\n  {\n    // Domain join and org resolution query `LOWER(allowed_domain)`.\n    // Keep that opt-in lookup indexed before it appears on any request path.\n    version: 1008,\n    sql: `CREATE INDEX IF NOT EXISTS organizations_lower_allowed_domain_idx ON organizations (LOWER(allowed_domain))`,\n  },\n];\n"]}

package/dist/provider-api/actions/github-repo-files.d.ts

@@ -0,0 +1,84 @@
+import { z } from "zod";
+import type { ProviderApiRuntime } from "../index.js";
+declare const GitHubRepoFilesActionSchema: z.ZodObject<{
+    operation: z.ZodEnum<{
+        search: "search";
+        list: "list";
+        delete: "delete";
+        write: "write";
+        read: "read";
+    }>;
+    owner: z.ZodString;
+    repo: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    ref: z.ZodOptional<z.ZodString>;
+    recursive: z.ZodOptional<z.ZodBoolean>;
+    includeDirectories: z.ZodOptional<z.ZodBoolean>;
+    query: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    extension: z.ZodOptional<z.ZodString>;
+    language: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    perPage: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    maxFiles: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    includeTextMatches: z.ZodOptional<z.ZodBoolean>;
+    content: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+    branch: z.ZodOptional<z.ZodString>;
+    sha: z.ZodOptional<z.ZodString>;
+    overwriteExisting: z.ZodOptional<z.ZodBoolean>;
+    committer: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodString;
+        date: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    author: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodString;
+        date: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    connectionId: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    maxBytes: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export interface CreateGitHubRepoFilesActionOptions {
+    description?: string;
+    requireApprovalForWrites?: boolean;
+}
+export declare function createGitHubRepoFilesAction(runtime: Pick<ProviderApiRuntime, "listGitHubRepositoryFiles" | "searchGitHubRepositoryFiles" | "readGitHubRepositoryFile" | "writeGitHubRepositoryFile" | "deleteGitHubRepositoryFile">, options?: CreateGitHubRepoFilesActionOptions): import("../../action.js").ActionDefinition<{
+    operation: "search" | "list" | "delete" | "write" | "read";
+    owner: string;
+    repo: string;
+    path?: string | undefined;
+    ref?: string | undefined;
+    recursive?: boolean | undefined;
+    includeDirectories?: boolean | undefined;
+    query?: string | undefined;
+    filename?: string | undefined;
+    extension?: string | undefined;
+    language?: string | undefined;
+    page?: unknown;
+    perPage?: unknown;
+    maxFiles?: unknown;
+    includeTextMatches?: boolean | undefined;
+    content?: string | undefined;
+    message?: string | undefined;
+    branch?: string | undefined;
+    sha?: string | undefined;
+    overwriteExisting?: boolean | undefined;
+    committer?: {
+        name: string;
+        email: string;
+        date?: string | undefined;
+    } | undefined;
+    author?: {
+        name: string;
+        email: string;
+        date?: string | undefined;
+    } | undefined;
+    connectionId?: string | undefined;
+    timeoutMs?: unknown;
+    maxBytes?: unknown;
+}, import("../index.js").GitHubRepositoryFileListResult | import("../index.js").GitHubRepositoryFileSearchResult | import("../index.js").GitHubRepositoryFileReadResult | import("../index.js").GitHubRepositoryFileDeleteResult>;
+export { GitHubRepoFilesActionSchema };
+//# sourceMappingURL=github-repo-files.d.ts.map

package/dist/provider-api/actions/github-repo-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-repo-files.d.ts","sourceRoot":"","sources":["../../../src/provider-api/actions/github-repo-files.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAMV,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAQrB,QAAA,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6H/B,CAAC;AAIH,MAAM,WAAW,kCAAkC;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,IAAI,CACX,kBAAkB,EAChB,2BAA2B,GAC3B,6BAA6B,GAC7B,0BAA0B,GAC1B,2BAA2B,GAC3B,4BAA4B,CAC/B,EACD,OAAO,GAAE,kCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kOAsGjD;AAED,OAAO,EAAE,2BAA2B,EAAE,CAAC"}

package/dist/provider-api/actions/github-repo-files.js

@@ -0,0 +1,213 @@
+import { defineAction } from "../../action.js";
+import { z } from "zod";
+const GitHubCommitIdentitySchema = z.object({
+    name: z.string().min(1).describe("Commit identity name."),
+    email: z.string().email().describe("Commit identity email."),
+    date: z.string().optional().describe("Optional ISO timestamp."),
+});
+const GitHubRepoFilesActionSchema = z.object({
+    operation: z
+        .enum(["list", "search", "read", "write", "delete"])
+        .describe("Operation to perform: list repository file paths, search code/files, read one file, create/update one file, or delete one file."),
+    owner: z.string().min(1).describe("Repository owner or organization."),
+    repo: z
+        .string()
+        .min(1)
+        .describe("Repository name, with or without a trailing .git suffix."),
+    path: z
+        .string()
+        .optional()
+        .describe("Repository-relative file or directory path. For search without query, this filters matching paths."),
+    ref: z
+        .string()
+        .optional()
+        .describe("Branch, tag, or commit-ish for list/read. Code search uses GitHub's default-branch search."),
+    recursive: z
+        .boolean()
+        .optional()
+        .describe("For list, read the repository tree recursively."),
+    includeDirectories: z
+        .boolean()
+        .optional()
+        .describe("For list, include directory entries along with files."),
+    query: z
+        .string()
+        .optional()
+        .describe("For search, a GitHub code-search term. Omit to search/filter file paths from the repository tree."),
+    filename: z
+        .string()
+        .optional()
+        .describe("For search, restrict to an exact filename."),
+    extension: z
+        .string()
+        .optional()
+        .describe("For search, restrict to a file extension such as ts or md."),
+    language: z
+        .string()
+        .optional()
+        .describe("For code search, restrict to a GitHub language qualifier."),
+    page: z.coerce
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe("For code search, result page to fetch."),
+    perPage: z.coerce
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe("For code search, results per page."),
+    maxFiles: z.coerce
+        .number()
+        .int()
+        .min(1)
+        .max(10_000)
+        .optional()
+        .describe("Maximum file entries to return from list or tree-filter search."),
+    includeTextMatches: z
+        .boolean()
+        .optional()
+        .describe("For code search, request GitHub text-match metadata."),
+    content: z
+        .string()
+        .optional()
+        .describe("For write, complete replacement UTF-8 file content."),
+    message: z.string().optional().describe("For write, commit message."),
+    branch: z
+        .string()
+        .optional()
+        .describe("For write, branch to create/update on. Defaults to GitHub's default branch."),
+    sha: z
+        .string()
+        .optional()
+        .describe("For write updates, the current blob SHA. The action reads it first by default when omitted."),
+    overwriteExisting: z
+        .boolean()
+        .optional()
+        .describe("For write, read the current file SHA first when sha is omitted, then update if it exists. Defaults to true."),
+    committer: GitHubCommitIdentitySchema.optional().describe("Optional GitHub contents API committer identity."),
+    author: GitHubCommitIdentitySchema.optional().describe("Optional GitHub contents API author identity."),
+    connectionId: z
+        .string()
+        .trim()
+        .min(1)
+        .optional()
+        .describe("Optional workspace GitHub connection id to use."),
+    timeoutMs: z.coerce
+        .number()
+        .int()
+        .min(1_000)
+        .max(120_000)
+        .optional()
+        .describe("Request timeout in milliseconds."),
+    maxBytes: z.coerce
+        .number()
+        .int()
+        .min(1_000)
+        .max(4 * 1024 * 1024)
+        .optional()
+        .describe("Maximum provider response bytes to read."),
+});
+export function createGitHubRepoFilesAction(runtime, options = {}) {
+    const requireApprovalForWrites = options.requireApprovalForWrites ?? true;
+    return defineAction({
+        description: options.description ??
+            "List, search, read, create/update, and delete GitHub repository files through the configured GitHub connector or GITHUB_TOKEN. Uses GitHub REST APIs directly; it does not clone repositories or use a filesystem sandbox.",
+        schema: GitHubRepoFilesActionSchema,
+        http: false,
+        needsApproval: requireApprovalForWrites
+            ? (args) => args.operation === "write" || args.operation === "delete"
+            : false,
+        run: async (args) => {
+            if (args.operation === "list") {
+                return runtime.listGitHubRepositoryFiles({
+                    owner: args.owner,
+                    repo: args.repo,
+                    path: args.path,
+                    ref: args.ref,
+                    recursive: args.recursive,
+                    includeDirectories: args.includeDirectories,
+                    maxFiles: args.maxFiles,
+                    connectionId: args.connectionId,
+                    timeoutMs: args.timeoutMs,
+                    maxBytes: args.maxBytes,
+                });
+            }
+            if (args.operation === "search") {
+                return runtime.searchGitHubRepositoryFiles({
+                    owner: args.owner,
+                    repo: args.repo,
+                    query: args.query,
+                    path: args.path,
+                    filename: args.filename,
+                    extension: args.extension,
+                    language: args.language,
+                    ref: args.ref,
+                    perPage: args.perPage,
+                    page: args.page,
+                    maxFiles: args.maxFiles,
+                    includeTextMatches: args.includeTextMatches,
+                    connectionId: args.connectionId,
+                    timeoutMs: args.timeoutMs,
+                    maxBytes: args.maxBytes,
+                });
+            }
+            if (args.operation === "read") {
+                if (!args.path)
+                    throw new Error("path is required for read.");
+                return runtime.readGitHubRepositoryFile({
+                    owner: args.owner,
+                    repo: args.repo,
+                    path: args.path,
+                    ref: args.ref,
+                    connectionId: args.connectionId,
+                    timeoutMs: args.timeoutMs,
+                    maxBytes: args.maxBytes,
+                });
+            }
+            if (!args.path) {
+                throw new Error(`path is required for ${args.operation}.`);
+            }
+            if (args.operation === "delete") {
+                return runtime.deleteGitHubRepositoryFile({
+                    owner: args.owner,
+                    repo: args.repo,
+                    path: args.path,
+                    message: args.message ?? `Delete ${args.path}`,
+                    branch: args.branch,
+                    sha: args.sha,
+                    committer: args.committer,
+                    author: args.author,
+                    connectionId: args.connectionId,
+                    timeoutMs: args.timeoutMs,
+                    maxBytes: args.maxBytes,
+                });
+            }
+            if (args.content === undefined) {
+                throw new Error("content is required for write.");
+            }
+            if (!args.message)
+                throw new Error("message is required for write.");
+            return runtime.writeGitHubRepositoryFile({
+                owner: args.owner,
+                repo: args.repo,
+                path: args.path,
+                content: args.content,
+                message: args.message,
+                branch: args.branch,
+                sha: args.sha,
+                overwriteExisting: args.overwriteExisting ?? true,
+                committer: args.committer,
+                author: args.author,
+                connectionId: args.connectionId,
+                timeoutMs: args.timeoutMs,
+                maxBytes: args.maxBytes,
+            });
+        },
+    });
+}
+export { GitHubRepoFilesActionSchema };
+//# sourceMappingURL=github-repo-files.js.map

package/dist/provider-api/actions/github-repo-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-repo-files.js","sourceRoot":"","sources":["../../../src/provider-api/actions/github-repo-files.ts"],"names":[],"mappings":"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","sourcesContent":["import { defineAction } from \"../../action.js\";\nimport { z } from \"zod\";\nimport type {\n  GitHubRepositoryFileDeleteArgs,\n  GitHubRepositoryFileListArgs,\n  GitHubRepositoryFileReadArgs,\n  GitHubRepositoryFileSearchArgs,\n  GitHubRepositoryFileWriteArgs,\n  ProviderApiRuntime,\n} from \"../index.js\";\n\nconst GitHubCommitIdentitySchema = z.object({\n  name: z.string().min(1).describe(\"Commit identity name.\"),\n  email: z.string().email().describe(\"Commit identity email.\"),\n  date: z.string().optional().describe(\"Optional ISO timestamp.\"),\n});\n\nconst GitHubRepoFilesActionSchema = z.object({\n  operation: z\n    .enum([\"list\", \"search\", \"read\", \"write\", \"delete\"])\n    .describe(\n      \"Operation to perform: list repository file paths, search code/files, read one file, create/update one file, or delete one file.\",\n    ),\n  owner: z.string().min(1).describe(\"Repository owner or organization.\"),\n  repo: z\n    .string()\n    .min(1)\n    .describe(\"Repository name, with or without a trailing .git suffix.\"),\n  path: z\n    .string()\n    .optional()\n    .describe(\n      \"Repository-relative file or directory path. For search without query, this filters matching paths.\",\n    ),\n  ref: z\n    .string()\n    .optional()\n    .describe(\n      \"Branch, tag, or commit-ish for list/read. Code search uses GitHub's default-branch search.\",\n    ),\n  recursive: z\n    .boolean()\n    .optional()\n    .describe(\"For list, read the repository tree recursively.\"),\n  includeDirectories: z\n    .boolean()\n    .optional()\n    .describe(\"For list, include directory entries along with files.\"),\n  query: z\n    .string()\n    .optional()\n    .describe(\n      \"For search, a GitHub code-search term. Omit to search/filter file paths from the repository tree.\",\n    ),\n  filename: z\n    .string()\n    .optional()\n    .describe(\"For search, restrict to an exact filename.\"),\n  extension: z\n    .string()\n    .optional()\n    .describe(\"For search, restrict to a file extension such as ts or md.\"),\n  language: z\n    .string()\n    .optional()\n    .describe(\"For code search, restrict to a GitHub language qualifier.\"),\n  page: z.coerce\n    .number()\n    .int()\n    .min(1)\n    .max(100)\n    .optional()\n    .describe(\"For code search, result page to fetch.\"),\n  perPage: z.coerce\n    .number()\n    .int()\n    .min(1)\n    .max(100)\n    .optional()\n    .describe(\"For code search, results per page.\"),\n  maxFiles: z.coerce\n    .number()\n    .int()\n    .min(1)\n    .max(10_000)\n    .optional()\n    .describe(\n      \"Maximum file entries to return from list or tree-filter search.\",\n    ),\n  includeTextMatches: z\n    .boolean()\n    .optional()\n    .describe(\"For code search, request GitHub text-match metadata.\"),\n  content: z\n    .string()\n    .optional()\n    .describe(\"For write, complete replacement UTF-8 file content.\"),\n  message: z.string().optional().describe(\"For write, commit message.\"),\n  branch: z\n    .string()\n    .optional()\n    .describe(\n      \"For write, branch to create/update on. Defaults to GitHub's default branch.\",\n    ),\n  sha: z\n    .string()\n    .optional()\n    .describe(\n      \"For write updates, the current blob SHA. The action reads it first by default when omitted.\",\n    ),\n  overwriteExisting: z\n    .boolean()\n    .optional()\n    .describe(\n      \"For write, read the current file SHA first when sha is omitted, then update if it exists. Defaults to true.\",\n    ),\n  committer: GitHubCommitIdentitySchema.optional().describe(\n    \"Optional GitHub contents API committer identity.\",\n  ),\n  author: GitHubCommitIdentitySchema.optional().describe(\n    \"Optional GitHub contents API author identity.\",\n  ),\n  connectionId: z\n    .string()\n    .trim()\n    .min(1)\n    .optional()\n    .describe(\"Optional workspace GitHub connection id to use.\"),\n  timeoutMs: z.coerce\n    .number()\n    .int()\n    .min(1_000)\n    .max(120_000)\n    .optional()\n    .describe(\"Request timeout in milliseconds.\"),\n  maxBytes: z.coerce\n    .number()\n    .int()\n    .min(1_000)\n    .max(4 * 1024 * 1024)\n    .optional()\n    .describe(\"Maximum provider response bytes to read.\"),\n});\n\ntype GitHubRepoFilesActionArgs = z.infer<typeof GitHubRepoFilesActionSchema>;\n\nexport interface CreateGitHubRepoFilesActionOptions {\n  description?: string;\n  requireApprovalForWrites?: boolean;\n}\n\nexport function createGitHubRepoFilesAction(\n  runtime: Pick<\n    ProviderApiRuntime,\n    | \"listGitHubRepositoryFiles\"\n    | \"searchGitHubRepositoryFiles\"\n    | \"readGitHubRepositoryFile\"\n    | \"writeGitHubRepositoryFile\"\n    | \"deleteGitHubRepositoryFile\"\n  >,\n  options: CreateGitHubRepoFilesActionOptions = {},\n) {\n  const requireApprovalForWrites = options.requireApprovalForWrites ?? true;\n  return defineAction({\n    description:\n      options.description ??\n      \"List, search, read, create/update, and delete GitHub repository files through the configured GitHub connector or GITHUB_TOKEN. Uses GitHub REST APIs directly; it does not clone repositories or use a filesystem sandbox.\",\n    schema: GitHubRepoFilesActionSchema,\n    http: false,\n    needsApproval: requireApprovalForWrites\n      ? (args: GitHubRepoFilesActionArgs) =>\n          args.operation === \"write\" || args.operation === \"delete\"\n      : false,\n    run: async (args) => {\n      if (args.operation === \"list\") {\n        return runtime.listGitHubRepositoryFiles({\n          owner: args.owner,\n          repo: args.repo,\n          path: args.path,\n          ref: args.ref,\n          recursive: args.recursive,\n          includeDirectories: args.includeDirectories,\n          maxFiles: args.maxFiles,\n          connectionId: args.connectionId,\n          timeoutMs: args.timeoutMs,\n          maxBytes: args.maxBytes,\n        } satisfies GitHubRepositoryFileListArgs);\n      }\n\n      if (args.operation === \"search\") {\n        return runtime.searchGitHubRepositoryFiles({\n          owner: args.owner,\n          repo: args.repo,\n          query: args.query,\n          path: args.path,\n          filename: args.filename,\n          extension: args.extension,\n          language: args.language,\n          ref: args.ref,\n          perPage: args.perPage,\n          page: args.page,\n          maxFiles: args.maxFiles,\n          includeTextMatches: args.includeTextMatches,\n          connectionId: args.connectionId,\n          timeoutMs: args.timeoutMs,\n          maxBytes: args.maxBytes,\n        } satisfies GitHubRepositoryFileSearchArgs);\n      }\n\n      if (args.operation === \"read\") {\n        if (!args.path) throw new Error(\"path is required for read.\");\n        return runtime.readGitHubRepositoryFile({\n          owner: args.owner,\n          repo: args.repo,\n          path: args.path,\n          ref: args.ref,\n          connectionId: args.connectionId,\n          timeoutMs: args.timeoutMs,\n          maxBytes: args.maxBytes,\n        } satisfies GitHubRepositoryFileReadArgs);\n      }\n\n      if (!args.path) {\n        throw new Error(`path is required for ${args.operation}.`);\n      }\n      if (args.operation === \"delete\") {\n        return runtime.deleteGitHubRepositoryFile({\n          owner: args.owner,\n          repo: args.repo,\n          path: args.path,\n          message: args.message ?? `Delete ${args.path}`,\n          branch: args.branch,\n          sha: args.sha,\n          committer: args.committer,\n          author: args.author,\n          connectionId: args.connectionId,\n          timeoutMs: args.timeoutMs,\n          maxBytes: args.maxBytes,\n        } satisfies GitHubRepositoryFileDeleteArgs);\n      }\n\n      if (args.content === undefined) {\n        throw new Error(\"content is required for write.\");\n      }\n      if (!args.message) throw new Error(\"message is required for write.\");\n      return runtime.writeGitHubRepositoryFile({\n        owner: args.owner,\n        repo: args.repo,\n        path: args.path,\n        content: args.content,\n        message: args.message,\n        branch: args.branch,\n        sha: args.sha,\n        overwriteExisting: args.overwriteExisting ?? true,\n        committer: args.committer,\n        author: args.author,\n        connectionId: args.connectionId,\n        timeoutMs: args.timeoutMs,\n        maxBytes: args.maxBytes,\n      } satisfies GitHubRepositoryFileWriteArgs);\n    },\n  });\n}\n\nexport { GitHubRepoFilesActionSchema };\n"]}

package/dist/provider-api/github-repo.d.ts

@@ -0,0 +1,11 @@
+import type { ActionEntry } from "../agent/production-agent.js";
+import type { CredentialContext } from "../credentials/index.js";
+import { type ProviderApiCredentialResolver } from "./index.js";
+interface GitHubRepoToolOptions {
+    appId?: string;
+    getCredentialContext?: () => CredentialContext | null;
+    resolveCredential?: ProviderApiCredentialResolver;
+}
+export declare function createGitHubRepoToolEntries(options?: GitHubRepoToolOptions): Record<string, ActionEntry>;
+export {};
+//# sourceMappingURL=github-repo.d.ts.map

package/dist/provider-api/github-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-repo.d.ts","sourceRoot":"","sources":["../../src/provider-api/github-repo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAKhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,EAGL,KAAK,6BAA6B,EAEnC,MAAM,YAAY,CAAC;AAEpB,UAAU,qBAAqB;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB,CAAC,EAAE,MAAM,iBAAiB,GAAG,IAAI,CAAC;IACtD,iBAAiB,CAAC,EAAE,6BAA6B,CAAC;CACnD;AAmfD,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CA2J7B"}