@friggframework/admin-scripts 2.0.0--canary.517.8eaf5df.0 → 2.0.0--canary.517.ff03f2c.0

package/README.md

@@ -36,7 +36,6 @@ const Definition = {
     adminScripts: [AttioHealingScript],
 
     admin: {
-        includeBuiltinScripts: true, // register oauth-token-refresh + integration-health-check
         enableScheduling: true, // provision EventBridge Scheduler resources
     },
 };
@@ -44,7 +43,7 @@ const Definition = {
 module.exports = { Definition };
 ```
 
-At deploy time the framework's `AdminScriptBuilder` provisions the SQS queue, the router + worker Lambdas, and (when `enableScheduling` is set) the EventBridge Scheduler group and IAM role. At runtime the router/worker load this app definition and register your scripts (plus the built-ins) into the script registry.
+At deploy time the framework's `AdminScriptBuilder` provisions the SQS queue, the router + worker Lambdas, and (when `enableScheduling` is set) the EventBridge Scheduler group and IAM role. At runtime the router/worker load this app definition and register your scripts into the script registry.
 
 ---
 
@@ -96,9 +95,14 @@ class AttioHealingScript extends AdminScriptBase {
             throw new Error(`Integration ${integrationId} not found`);
         }
 
-        // Call the live integration/API when you need it
+        // Call the live integration when you need to hit an external API.
+        // Modules are attached to the instance by their own name (from the
+        // module's getName(), e.g. `instance.attio`) and each module's `.api`
+        // is its authenticated client. Iterate `instance.modules` if you don't
+        // want to hard-code a module name. The methods on `.api` are defined by
+        // that specific API module.
         const instance = await this.context.instantiate(integrationId);
-        await instance.primary.api.refreshMetadata();
+        await instance.attio.api.refreshEntityConfig(); // example — use your module's real method
 
         this.context.log('info', 'Healing complete', { integrationId });
         return { healed: true, integrationId };
@@ -159,10 +163,10 @@ curl -X POST https://<your-app>/admin/scripts/attio-healing \
 **Sync** — runs inline and returns the result. Only for fast scripts: in a deployed environment, sync is rejected (`400 SYNC_TIMEOUT_TOO_LONG`) when the script's `config.timeout` exceeds the API Lambda budget (~25s). Use `async` for anything longer.
 
 ```bash
-curl -X POST https://<your-app>/admin/scripts/integration-health-check \
+curl -X POST https://<your-app>/admin/scripts/attio-healing \
   -H "x-frigg-admin-api-key: $ADMIN_API_KEY" \
   -H "Content-Type: application/json" \
-  -d '{ "params": {}, "mode": "sync" }'
+  -d '{ "params": { "integrationId": "abc123" }, "mode": "sync" }'
 
 # 200 OK
 # { "executionId": "...", "status": "COMPLETED", "output": { ... }, "metrics": { "durationMs": 812 } }
@@ -203,29 +207,20 @@ A script can ship a default schedule in its `Definition.schedule`, and operators
 
 ```bash
 # Enable a daily 6am UTC run
-curl -X PUT https://<your-app>/admin/scripts/integration-health-check/schedule \
+curl -X PUT https://<your-app>/admin/scripts/attio-healing/schedule \
   -H "x-frigg-admin-api-key: $ADMIN_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{ "enabled": true, "cronExpression": "cron(0 6 * * ? *)", "timezone": "UTC" }'
 
 # Inspect / remove
-curl https://<your-app>/admin/scripts/integration-health-check/schedule -H "x-frigg-admin-api-key: $ADMIN_API_KEY"
-curl -X DELETE https://<your-app>/admin/scripts/integration-health-check/schedule -H "x-frigg-admin-api-key: $ADMIN_API_KEY"
+curl https://<your-app>/admin/scripts/attio-healing/schedule -H "x-frigg-admin-api-key: $ADMIN_API_KEY"
+curl -X DELETE https://<your-app>/admin/scripts/attio-healing/schedule -H "x-frigg-admin-api-key: $ADMIN_API_KEY"
 ```
 
 Scheduling requires `admin.enableScheduling: true` in the app definition (so the EventBridge Scheduler group, IAM role, and env vars are provisioned). In a deployed environment the router refuses to fall back to the in-memory local scheduler, returning `503 SCHEDULER_NOT_CONFIGURED` if the provider isn't wired.
 
 ---
 
-## Built-in scripts
-
-Set `admin.includeBuiltinScripts: true` to register:
-
--   **`oauth-token-refresh`** — refreshes OAuth tokens for integrations nearing expiry. Params: `integrationIds?`, `expiryThresholdHours` (default 24), `dryRun`.
--   **`integration-health-check`** — checks credential validity and API connectivity. Params: `integrationIds?`, `checkCredentials` (default true), `checkConnectivity` (default true), `updateStatus` (default false).
-
----
-
 ## Script chaining
 
 Long or fan-out work can enqueue follow-up scripts. Continuations are tracked with `parentExecutionId` so you can trace the lineage:

package/index.js

@@ -37,14 +37,6 @@ const {
     handler: executorHandler,
 } = require('./src/infrastructure/script-executor-handler');
 
-// Built-in Scripts
-const {
-    OAuthTokenRefreshScript,
-    IntegrationHealthCheckScript,
-    builtinScripts,
-    registerBuiltinScripts,
-} = require('./src/builtins');
-
 // Adapters
 const { SchedulerAdapter } = require('./src/adapters/scheduler-adapter');
 const { AWSSchedulerAdapter } = require('./src/adapters/aws-scheduler-adapter');
@@ -76,12 +68,6 @@ module.exports = {
     routerHandler,
     executorHandler,
 
-    // Built-in scripts
-    OAuthTokenRefreshScript,
-    IntegrationHealthCheckScript,
-    builtinScripts,
-    registerBuiltinScripts,
-
     // Adapters
     SchedulerAdapter,
     AWSSchedulerAdapter,

package/package.json

@@ -1,18 +1,18 @@
 {
     "name": "@friggframework/admin-scripts",
     "prettier": "@friggframework/prettier-config",
-    "version": "2.0.0--canary.517.8eaf5df.0",
+    "version": "2.0.0--canary.517.ff03f2c.0",
     "description": "Admin Script Runner for Frigg - Execute maintenance and operational scripts in hosted environments",
     "dependencies": {
         "@aws-sdk/client-scheduler": "^3.588.0",
-        "@friggframework/core": "2.0.0--canary.517.8eaf5df.0",
+        "@friggframework/core": "2.0.0--canary.517.ff03f2c.0",
         "express": "^4.18.2",
         "serverless-http": "^3.2.0"
     },
     "devDependencies": {
-        "@friggframework/eslint-config": "2.0.0--canary.517.8eaf5df.0",
-        "@friggframework/prettier-config": "2.0.0--canary.517.8eaf5df.0",
-        "@friggframework/test": "2.0.0--canary.517.8eaf5df.0",
+        "@friggframework/eslint-config": "2.0.0--canary.517.ff03f2c.0",
+        "@friggframework/prettier-config": "2.0.0--canary.517.ff03f2c.0",
+        "@friggframework/test": "2.0.0--canary.517.ff03f2c.0",
         "eslint": "^8.22.0",
         "jest": "^29.7.0",
         "prettier": "^2.7.1",
@@ -43,5 +43,5 @@
         "maintenance",
         "operations"
     ],
-    "gitHead": "8eaf5df0746c979fc5cb7877d51a861becd5fbce"
+    "gitHead": "ff03f2c9204a318789ed105c09cc9d44deeae6ec"
 }

package/src/infrastructure/bootstrap.js

@@ -55,15 +55,10 @@ function bootstrapAdminScripts() {
         const {
             loadAppDefinition,
         } = require('@friggframework/core/handlers/app-definition-loader');
-        const { adminScripts = [], admin = {} } = loadAppDefinition();
+        const { adminScripts = [] } = loadAppDefinition();
 
         const factory = getScriptFactory();
         registerScripts(factory, adminScripts);
-
-        if (admin.includeBuiltinScripts) {
-            const { builtinScripts } = require('../builtins');
-            registerScripts(factory, builtinScripts);
-        }
     } catch (error) {
         console.error(
             '[admin-scripts] bootstrap: could not load app definition:',