@aws/nx-plugin 1.0.0-rc.9 → 1.0.0-rc.90

package/src/agentcore-gateway/react-connection/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/agentcore-gateway/react-connection/schema.d.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport type { ComponentMetadata } from '../../utils/nx.js';\n\nexport interface AgentcoreGatewayReactConnectionGeneratorSchema {\n  sourceProject: string;\n  targetProject: string;\n  sourceComponent?: ComponentMetadata;\n  targetComponent?: ComponentMetadata;\n  preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAGD,WAMC"}

package/src/agentcore-gateway/react-connection/schema.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ComponentMetadata } from '../../utils/nx.js';
+
+export interface AgentcoreGatewayReactConnectionGeneratorSchema {
+  sourceProject: string;
+  targetProject: string;
+  sourceComponent?: ComponentMetadata;
+  targetComponent?: ComponentMetadata;
+  preferInstallDependencies?: boolean;
+}

package/src/agentcore-gateway/react-connection/schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "agentcore-gateway#react-connection",
+  "title": "agentcore-gateway#react-connection",
+  "description": "Connect a React website to an AgentCore Gateway fronting agents",
+  "type": "object",
+  "properties": {
+    "sourceProject": {
+      "type": "string",
+      "description": "The React website project"
+    },
+    "targetProject": {
+      "type": "string",
+      "description": "The gateway project"
+    },
+    "sourceComponent": {
+      "type": "string",
+      "description": "The website component in the source project"
+    },
+    "targetComponent": {
+      "type": "string",
+      "description": "The gateway component in the target project"
+    },
+    "preferInstallDependencies": {
+      "type": "boolean",
+      "description": "Whether to prefer installing dependencies after the generator runs. Set to false to defer installing when batching multiple generators (an install still runs if needed so subsequent generators can compute the Nx project graph); install once at the end.",
+      "default": true
+    }
+  },
+  "required": ["sourceProject", "targetProject"]
+}

package/src/agentcore-gateway/schema.d.js

@@ -0,0 +1,6 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ export { };
+
+//# sourceMappingURL=schema.d.js.map

package/src/agentcore-gateway/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/agentcore-gateway/schema.d.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport type { IacOption } from '../utils/iac.js';\n\nexport interface AgentcoreGatewayGeneratorSchema {\n  name: string;\n  directory?: string;\n  subDirectory?: string;\n  protocol?: 'mcp' | 'http';\n  auth?: 'iam' | 'cognito';\n  cedarPolicy?: boolean;\n  infra?: 'agentcore' | 'none';\n  iac: IacOption;\n  preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAGD,WAUC"}

package/src/agentcore-gateway/schema.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { IacOption } from '../utils/iac.js';
+
+export interface AgentcoreGatewayGeneratorSchema {
+  name: string;
+  directory?: string;
+  subDirectory?: string;
+  protocol?: 'mcp' | 'http';
+  auth?: 'iam' | 'cognito';
+  cedarPolicy?: boolean;
+  infra?: 'agentcore' | 'none';
+  iac: IacOption;
+  preferInstallDependencies?: boolean;
+}

package/src/agentcore-gateway/schema.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "agentcore-gateway",
+  "title": "agentcore-gateway",
+  "x-label": "AgentCore Gateway",
+  "description": "Generate an AgentCore Gateway project",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The name of your AgentCore Gateway project",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What would you like to call your AgentCore Gateway?",
+      "x-priority": "important"
+    },
+    "directory": {
+      "type": "string",
+      "description": "Parent directory where the gateway project is placed.",
+      "default": "packages"
+    },
+    "subDirectory": {
+      "type": "string",
+      "description": "The sub directory the project is placed in. By default this is the project name."
+    },
+    "protocol": {
+      "type": "string",
+      "description": "The inbound protocol exposed by your gateway. An mcp gateway aggregates MCP server targets into a single MCP endpoint. An http gateway proxies requests to agent runtime targets via path-based routing, so callers (e.g. a website) can reach agents through the gateway.",
+      "enum": ["mcp", "http"],
+      "default": "mcp",
+      "x-priority": "important"
+    },
+    "auth": {
+      "type": "string",
+      "description": "The method used to authenticate inbound requests to your gateway. Only applicable when infra is set (ignored when infra is none).",
+      "enum": ["iam", "cognito"],
+      "default": "iam",
+      "x-prompt": "How would you like to authenticate inbound requests to your gateway?",
+      "x-priority": "important"
+    },
+    "cedarPolicy": {
+      "type": "boolean",
+      "description": "Whether to include a Cedar policy engine enforcing fine-grained authorization on the gateway.",
+      "default": true,
+      "x-priority": "important"
+    },
+    "infra": {
+      "type": "string",
+      "description": "The type of infrastructure to host your gateway. Select none for no hosting.",
+      "x-prompt": "How would you like to host your gateway?",
+      "enum": ["agentcore", "none"],
+      "default": "agentcore",
+      "x-priority": "important"
+    },
+    "iac": {
+      "type": "string",
+      "description": "The preferred IaC provider. By default this is inherited from your initial selection.",
+      "enum": ["inherit", "cdk", "terraform"],
+      "x-priority": "important",
+      "default": "inherit",
+      "x-prompt": "Which provider would you like to manage your infrastructure? (default: inherit)"
+    },
+    "preferInstallDependencies": {
+      "type": "boolean",
+      "description": "Whether to prefer installing dependencies after the generator runs. Set to false to defer installing when batching multiple generators (an install still runs if needed so subsequent generators can compute the Nx project graph); install once at the end.",
+      "default": true
+    }
+  },
+  "required": ["name"]
+}

package/src/agentcore-harness/__snapshots__/generator.spec.ts.snap

@@ -0,0 +1,237 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`agentcore-harness generator > snapshot > snapshots the four rendered harness project files > packages/my-harness/README.md 1`] = `
+"# @proj/my-harness
+
+An [Amazon Bedrock AgentCore Harness](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/harness.html)
+project generated with [@aws/nx-plugin](https://github.com/awslabs/nx-plugin-for-aws/).
+A Harness is a managed agent loop that AWS runs for you, so this project
+holds only the prompt that shapes it and a script for talking to it:
+
+- \`src/PROMPT.md\` — the system prompt
+- \`scripts/chat.ts\` — a multi-turn chat client for the deployed Harness
+- \`project.json\` — declares the \`chat\` target
+- \`README.md\` — this file
+
+The Harness itself is deployed by the generated CDK construct or Terraform
+module through your usual infrastructure workflow.
+
+## The system prompt
+
+\`src/PROMPT.md\` is the Harness system prompt. Your infrastructure reads the
+file when you synthesize (CDK) or plan (Terraform), so edit it and redeploy
+to change how the Harness behaves.
+
+The prompt is deployment configuration rather than secret storage: its
+contents appear in the synthesized CloudFormation template or in Terraform
+state.
+
+## Chatting with your Harness
+
+\`\`\`bash
+pnpm nx run @proj/my-harness:chat
+\`\`\`
+
+Every turn of a run shares one session, so the Harness keeps the
+conversation context until you exit.
+
+The Harness ARN is resolved in this order:
+
+1. \`HARNESS_ARN\`, used directly:
+
+   \`\`\`bash
+   HARNESS_ARN=<harness-arn> pnpm nx run @proj/my-harness:chat
+   \`\`\`
+
+2. \`RUNTIME_CONFIG_APP_ID\`, which reads the
+   \`agentcore.harnesses.MyHarness\` entry your deployed
+   infrastructure publishes:
+
+   \`\`\`bash
+   RUNTIME_CONFIG_APP_ID=<application-id> pnpm nx run @proj/my-harness:chat
+   \`\`\`
+
+With neither set, the script fails with an error naming both. The AWS Region
+is derived from the Harness ARN, and credentials come from the standard AWS
+SDK credential provider chain.
+
+A caller needs \`bedrock-agentcore:InvokeHarness\` and
+\`bedrock-agentcore:InvokeAgentRuntime\` on the Harness ARN. The CDK
+construct's \`grantInvokeAccess\` grants exactly those two actions.
+
+## Customizing your Harness
+
+Edit \`src/PROMPT.md\` for the system prompt. Everything else is configured
+where you instantiate the infrastructure — including tools, which default
+to none:
+
+- CDK construct props, for example
+  \`new MyHarness(this, 'MyHarness', { allowedTools: ['@builtin'] })\`
+- Terraform, by setting the module's \`allowed_tools\` variable, for example
+  \`allowed_tools = ["@builtin"]\`
+
+The generated infrastructure is also yours to edit directly:
+
+- \`packages/common/constructs/src/app/harnesses/my-harness/my-harness.ts\`
+- \`packages/common/terraform/src/app/harnesses/my-harness/my-harness.tf\`
+
+Re-running the generator only adds missing files, so your edits to these
+files and to \`src/PROMPT.md\` are preserved.
+
+## Further reading
+
+- [AgentCore Harness guide](https://awslabs.github.io/nx-plugin-for-aws/guides/agentcore-harness/)
+- [Amazon Bedrock AgentCore Harness documentation](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/harness.html)
+- [Learn more about Nx](https://nx.dev/getting-started/intro)
+"
+`;
+
+exports[`agentcore-harness generator > snapshot > snapshots the four rendered harness project files > packages/my-harness/project.json 1`] = `
+"{
+  "name": "@proj/my-harness",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "projectType": "application",
+  "sourceRoot": "packages/my-harness",
+  "tags": [],
+  "metadata": {
+    "generator": "agentcore-harness",
+    "name": "my-harness",
+    "rc": "MyHarness",
+    "auth": "iam",
+    "iac": "cdk"
+  },
+  "targets": {
+    "chat": {
+      "executor": "nx:run-commands",
+      "options": {
+        "commands": ["tsx ./scripts/chat.ts"],
+        "cwd": "{projectRoot}"
+      }
+    }
+  }
+}
+"
+`;
+
+exports[`agentcore-harness generator > snapshot > snapshots the four rendered harness project files > packages/my-harness/scripts/chat.ts 1`] = `
+"// Chat CLI for MyHarness. Invokes the deployed Harness with InvokeHarness.
+import { randomUUID } from 'node:crypto';
+import { getAppConfig } from '@aws-lambda-powertools/parameters/appconfig';
+import {
+  BedrockAgentCoreClient,
+  InvokeHarnessCommand,
+} from '@aws-sdk/client-bedrock-agentcore';
+import { chatLoop, type ChatAdapter } from 'agent-chat-cli';
+
+// The deployed infrastructure publishes the Harness ARN at
+// \`agentcore.harnesses.MyHarness\`.
+const HARNESS_RUNTIME_CONFIG_KEY = 'MyHarness';
+
+// One session id per run, so every turn continues the same Harness session.
+const SESSION_ID = randomUUID();
+
+// Empty strings count as absent, so \`HARNESS_ARN= nx run ...\` still discovers.
+const isPresent = (value: string | undefined): value is string =>
+  value !== undefined && value !== '';
+
+// \`HARNESS_ARN\` wins; \`RUNTIME_CONFIG_APP_ID\` reads the runtime configuration.
+const resolveHarnessArn = async (): Promise<string> => {
+  if (isPresent(process.env.HARNESS_ARN)) {
+    return process.env.HARNESS_ARN;
+  }
+  const application = process.env.RUNTIME_CONFIG_APP_ID;
+  if (!isPresent(application)) {
+    throw new Error(
+      'No Harness ARN source is configured. Set HARNESS_ARN to the deployed ' +
+        'Harness ARN directly, or set RUNTIME_CONFIG_APP_ID to the AppConfig ' +
+        'application ID emitted by your infrastructure stack.',
+    );
+  }
+  const config = (await getAppConfig('agentcore', {
+    application,
+    environment: 'default',
+    transform: 'json',
+  })) as { harnesses?: Record<string, string | undefined> };
+  const harnessArn = config?.harnesses?.[HARNESS_RUNTIME_CONFIG_KEY];
+  if (!harnessArn) {
+    throw new Error(
+      \`Runtime configuration for application '\${application}' has no value \` +
+        \`at 'agentcore.harnesses.\${HARNESS_RUNTIME_CONFIG_KEY}'. Deploy the \` +
+        'Harness infrastructure first, or set HARNESS_ARN directly.',
+    );
+  }
+  return harnessArn;
+};
+
+const HARNESS_ARN = await resolveHarnessArn();
+
+// Region comes from the ARN, and credentials from the standard AWS SDK
+// default provider chain, so no Region is embedded in this project.
+const client = new BedrockAgentCoreClient({
+  region: HARNESS_ARN.split(':')[3],
+});
+
+class HarnessAdapter implements ChatAdapter {
+  async connect() {
+    return { agentName: 'MyHarness' };
+  }
+
+  async *sendMessage(text: string): AsyncIterable<string> {
+    const { stream } = await client.send(
+      new InvokeHarnessCommand({
+        harnessArn: HARNESS_ARN,
+        runtimeSessionId: SESSION_ID,
+        messages: [{ role: 'user', content: [{ text }] }],
+      }),
+    );
+    if (!stream) {
+      throw new Error(
+        'AgentCore returned no event stream for the invocation. Confirm the ' +
+          'Harness is deployed and the caller has the ' +
+          'bedrock-agentcore:InvokeHarness permission.',
+      );
+    }
+    for await (const event of stream) {
+      const serviceError =
+        event.internalServerException ??
+        event.validationException ??
+        event.runtimeClientError;
+      if (serviceError) {
+        const detail = [serviceError.name, serviceError.message]
+          .filter(Boolean)
+          .join(': ');
+        throw new Error(
+          \`Harness invocation failed: \${detail || JSON.stringify(serviceError)}\`,
+        );
+      }
+      const chunk = event.contentBlockDelta?.delta?.text;
+      if (chunk) {
+        yield chunk;
+      }
+    }
+  }
+}
+
+await chatLoop(new HarnessAdapter(), '');
+"
+`;
+
+exports[`agentcore-harness generator > snapshot > snapshots the four rendered harness project files > packages/my-harness/src/PROMPT.md 1`] = `
+"# MyHarness
+
+You are a helpful AI assistant.
+
+## Responding
+
+- Lead with the answer, then the supporting detail.
+- Keep the response proportional to the request: short answers to simple
+  questions, thorough answers to involved ones.
+- Ask for the detail you need when a request is ambiguous instead of guessing.
+- Say when you do not know something, and say what would settle it.
+
+## Using tools
+
+When tools are available, prefer them over recollection for anything you can
+look up, and report what a tool returned, including when it fails.
+"
+`;

package/src/agentcore-harness/files/project/README.md.template

@@ -0,0 +1,82 @@
+# <%- fullyQualifiedName %>
+
+An [Amazon Bedrock AgentCore Harness](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/harness.html)
+project generated with [@aws/nx-plugin](https://github.com/awslabs/nx-plugin-for-aws/).
+A Harness is a managed agent loop that AWS runs for you, so this project
+holds only the prompt that shapes it and a script for talking to it:
+
+- `src/PROMPT.md` — the system prompt
+- `scripts/chat.ts` — a multi-turn chat client for the deployed Harness
+- `project.json` — declares the `chat` target
+- `README.md` — this file
+
+The Harness itself is deployed by the generated CDK construct or Terraform
+module through your usual infrastructure workflow.
+
+## The system prompt
+
+`src/PROMPT.md` is the Harness system prompt. Your infrastructure reads the
+file when you synthesize (CDK) or plan (Terraform), so edit it and redeploy
+to change how the Harness behaves.
+
+The prompt is deployment configuration rather than secret storage: its
+contents appear in the synthesized CloudFormation template or in Terraform
+state.
+
+## Chatting with your Harness
+
+```bash
+pnpm nx run <%- fullyQualifiedName %>:chat
+```
+
+Every turn of a run shares one session, so the Harness keeps the
+conversation context until you exit.
+
+The Harness ARN is resolved in this order:
+
+1. `HARNESS_ARN`, used directly:
+
+   ```bash
+   HARNESS_ARN=<harness-arn> pnpm nx run <%- fullyQualifiedName %>:chat
+   ```
+
+2. `RUNTIME_CONFIG_APP_ID`, which reads the
+   `agentcore.harnesses.<%- nameClassName %>` entry your deployed
+   infrastructure publishes:
+
+   ```bash
+   RUNTIME_CONFIG_APP_ID=<application-id> pnpm nx run <%- fullyQualifiedName %>:chat
+   ```
+
+With neither set, the script fails with an error naming both. The AWS Region
+is derived from the Harness ARN, and credentials come from the standard AWS
+SDK credential provider chain.
+
+A caller needs `bedrock-agentcore:InvokeHarness` and
+`bedrock-agentcore:InvokeAgentRuntime` on the Harness ARN. The CDK
+construct's `grantInvokeAccess` grants exactly those two actions.
+
+## Customizing your Harness
+
+Edit `src/PROMPT.md` for the system prompt. Everything else is configured
+where you instantiate the infrastructure — including tools, which default
+to none:
+
+- CDK construct props, for example
+  `new <%- nameClassName %>(this, '<%- nameClassName %>', { allowedTools: ['@builtin'] })`
+- Terraform, by setting the module's `allowed_tools` variable, for example
+  `allowed_tools = ["@builtin"]`
+
+The generated infrastructure is also yours to edit directly:
+
+- `packages/common/constructs/src/app/harnesses/<%- nameKebabCase %>/<%- nameKebabCase %>.ts`
+- `packages/common/terraform/src/app/harnesses/<%- nameKebabCase %>/<%- nameKebabCase %>.tf`
+
+Re-running the generator only adds missing files, so your edits to these
+files and to `src/PROMPT.md` are preserved.
+
+## Further reading
+
+- [AgentCore Harness guide](https://awslabs.github.io/nx-plugin-for-aws/guides/agentcore-harness/)
+- [Amazon Bedrock AgentCore Harness documentation](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/harness.html)
+- [Learn more about Nx](https://nx.dev/getting-started/intro)

package/src/agentcore-harness/files/project/scripts/chat.ts.template

@@ -0,0 +1,99 @@
+// Chat CLI for <%- nameClassName %>. Invokes the deployed Harness with InvokeHarness.
+import { randomUUID } from 'node:crypto';
+import { getAppConfig } from '@aws-lambda-powertools/parameters/appconfig';
+import {
+  BedrockAgentCoreClient,
+  InvokeHarnessCommand,
+} from '@aws-sdk/client-bedrock-agentcore';
+import { chatLoop, type ChatAdapter } from 'agent-chat-cli';
+
+// The deployed infrastructure publishes the Harness ARN at
+// `agentcore.harnesses.<%- nameClassName %>`.
+const HARNESS_RUNTIME_CONFIG_KEY = '<%- nameClassName %>';
+
+// One session id per run, so every turn continues the same Harness session.
+const SESSION_ID = randomUUID();
+
+// Empty strings count as absent, so `HARNESS_ARN= nx run ...` still discovers.
+const isPresent = (value: string | undefined): value is string =>
+  value !== undefined && value !== '';
+
+// `HARNESS_ARN` wins; `RUNTIME_CONFIG_APP_ID` reads the runtime configuration.
+const resolveHarnessArn = async (): Promise<string> => {
+  if (isPresent(process.env.HARNESS_ARN)) {
+    return process.env.HARNESS_ARN;
+  }
+  const application = process.env.RUNTIME_CONFIG_APP_ID;
+  if (!isPresent(application)) {
+    throw new Error(
+      'No Harness ARN source is configured. Set HARNESS_ARN to the deployed ' +
+        'Harness ARN directly, or set RUNTIME_CONFIG_APP_ID to the AppConfig ' +
+        'application ID emitted by your infrastructure stack.',
+    );
+  }
+  const config = (await getAppConfig('agentcore', {
+    application,
+    environment: 'default',
+    transform: 'json',
+  })) as { harnesses?: Record<string, string | undefined> };
+  const harnessArn = config?.harnesses?.[HARNESS_RUNTIME_CONFIG_KEY];
+  if (!harnessArn) {
+    throw new Error(
+      `Runtime configuration for application '${application}' has no value ` +
+        `at 'agentcore.harnesses.${HARNESS_RUNTIME_CONFIG_KEY}'. Deploy the ` +
+        'Harness infrastructure first, or set HARNESS_ARN directly.',
+    );
+  }
+  return harnessArn;
+};
+
+const HARNESS_ARN = await resolveHarnessArn();
+
+// Region comes from the ARN, and credentials from the standard AWS SDK
+// default provider chain, so no Region is embedded in this project.
+const client = new BedrockAgentCoreClient({
+  region: HARNESS_ARN.split(':')[3],
+});
+
+class HarnessAdapter implements ChatAdapter {
+  async connect() {
+    return { agentName: '<%- nameClassName %>' };
+  }
+
+  async *sendMessage(text: string): AsyncIterable<string> {
+    const { stream } = await client.send(
+      new InvokeHarnessCommand({
+        harnessArn: HARNESS_ARN,
+        runtimeSessionId: SESSION_ID,
+        messages: [{ role: 'user', content: [{ text }] }],
+      }),
+    );
+    if (!stream) {
+      throw new Error(
+        'AgentCore returned no event stream for the invocation. Confirm the ' +
+          'Harness is deployed and the caller has the ' +
+          'bedrock-agentcore:InvokeHarness permission.',
+      );
+    }
+    for await (const event of stream) {
+      const serviceError =
+        event.internalServerException ??
+        event.validationException ??
+        event.runtimeClientError;
+      if (serviceError) {
+        const detail = [serviceError.name, serviceError.message]
+          .filter(Boolean)
+          .join(': ');
+        throw new Error(
+          `Harness invocation failed: ${detail || JSON.stringify(serviceError)}`,
+        );
+      }
+      const chunk = event.contentBlockDelta?.delta?.text;
+      if (chunk) {
+        yield chunk;
+      }
+    }
+  }
+}
+
+await chatLoop(new HarnessAdapter(), '');

package/src/agentcore-harness/files/project/src/PROMPT.md.template

@@ -0,0 +1,16 @@
+# <%- nameClassName %>
+
+You are a helpful AI assistant.
+
+## Responding
+
+- Lead with the answer, then the supporting detail.
+- Keep the response proportional to the request: short answers to simple
+  questions, thorough answers to involved ones.
+- Ask for the detail you need when a request is ambiguous instead of guessing.
+- Say when you do not know something, and say what would settle it.
+
+## Using tools
+
+When tools are available, prefer them over recollection for anything you can
+look up, and report what a tool returned, including when it fails.

package/src/agentcore-harness/generator.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type GeneratorCallback, type ProjectConfiguration, type Tree } from '@nx/devkit';
+import { type NxGeneratorInfo } from '../utils/nx.js';
+import type { IacMetadata } from '../utils/shared-constructs-constants.js';
+import type { AgentcoreHarnessGeneratorSchema } from './schema';
+export declare const DEPENDENCIES: import("../utils/declared-dependencies.js").DependencyDeclaration<readonly [{
+    readonly name: "@aws-sdk/client-bedrock-agentcore";
+    readonly root: true;
+}, {
+    readonly name: "@aws-sdk/client-appconfigdata";
+    readonly root: true;
+}, {
+    readonly name: "@aws-lambda-powertools/parameters";
+    readonly root: true;
+}, {
+    readonly name: "agent-chat-cli";
+    readonly root: true;
+}, {
+    readonly name: "@types/node";
+    readonly dev: true;
+    readonly root: true;
+}, {
+    readonly name: "tsx";
+    readonly dev: true;
+    readonly root: true;
+}, {
+    readonly name: "constructs";
+    readonly when: (m: IacMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "aws-cdk-lib";
+    readonly when: (m: IacMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "@types/node";
+} & {
+    versionOnly: true;
+}], readonly import("../utils/declared-dependencies.js").DeclaredPyDependency<"a2a-sdk" | "ag-ui-langgraph" | "ag-ui-protocol" | "ag-ui-strands" | "aiosqlite" | "aws-lambda-powertools" | "aws-lambda-powertools[tracer]" | "aws-lambda-powertools[parser]" | "aws-opentelemetry-distro" | "bedrock-agentcore" | "boto3" | "checkov" | "fastapi" | "fastapi[standard]" | "httpx" | "langchain" | "langchain-aws" | "langchain-mcp-adapters" | "langgraph" | "langgraph-checkpoint-aws" | "langgraph-checkpoint-sqlite" | "mcp" | "pip-check-updates" | "pip-licenses" | "ruff" | "strands-agents" | "strands-agents[a2a]" | "strands-agents-tools" | "ty" | "pynamodb" | "uvicorn" | "sqlmodel" | "alembic" | "aiomysql" | "asyncpg" | "greenlet", AgentCoreHarnessMetadata>[]>;
+export declare const AGENTCORE_HARNESS_GENERATOR_INFO: NxGeneratorInfo;
+export declare const agentcoreHarnessGenerator: (tree: Tree, options: AgentcoreHarnessGeneratorSchema) => Promise<GeneratorCallback>;
+/**
+ * Harness details stored in the Harness Project's metadata. `iac` records which
+ * provider's infrastructure was written, so the version sync can tell which
+ * shared constructs packages this project owns.
+ */
+export interface AgentCoreHarnessMetadata extends IacMetadata {
+    generator: string;
+    name: string;
+    rc: string;
+    auth: 'iam';
+}
+/**
+ * Read a Harness Project's metadata, validating it was generated by the
+ * agentcore-harness generator before returning typed data.
+ */
+export declare const readAgentCoreHarnessMetadata: (project: ProjectConfiguration) => AgentCoreHarnessMetadata;
+export default agentcoreHarnessGenerator;