@openhands/agent-canvas 1.15.0 → 1.17.0

package/dist/manifests/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../src/manifests/types.ts"],"sourcesContent":["/**\n * Host-owned shape of an extension-authored setup experience.\n *\n * A catalog entry is declarative data published by `@openhands/extensions`. Its\n * optional `setup` block says what to ask a user for; everything derivable from\n * that — the request to send, the route, the review screen, the analytics — is\n * this host's to generate, so none of it appears here.\n *\n * The names mirror `@openhands/extensions/automations`' own declarations, so an\n * entry from the published package assigns without an adapter.\n */\n\nexport const SETUP_VERSION = \"1.0\";\n\nexport type SetupMode = \"direct\" | \"assisted\";\n\nexport type SetupFieldType =\n  | \"text\"\n  | \"textarea\"\n  | \"select\"\n  | \"cron\"\n  | \"timezone\"\n  | \"repo-picker\";\n\nexport type SetupGitProvider = \"github\" | \"gitlab\" | \"bitbucket\";\n\nexport type SetupTriggerKind = \"cron\" | \"event\";\n\n/** Placeholder namespaces a setup block may reference inside `{{...}}`. */\nexport const SETUP_PLACEHOLDER_NAMESPACES = [\"form\", \"automation\"] as const;\n\nexport interface SetupFieldOption {\n  value: string;\n  label: string;\n}\n\nexport interface SetupFieldConstraints {\n  minLength?: number;\n  maxLength?: number;\n  /**\n   * A host-implemented check named from a closed set. Entries supply no regex\n   * of their own, so they cannot hand the host a pathological pattern.\n   */\n  format?: \"safeExpressionLiteral\";\n}\n\nexport interface SetupFormField {\n  type: SetupFieldType;\n  label: string;\n  help: string;\n  placeholder?: string;\n  default?: string;\n  required: boolean;\n  provider?: SetupGitProvider;\n  /**\n   * repo-picker only. The field collects several repositories rather than one,\n   * and its value is a list. A placeholder that is the whole value resolves to\n   * that list, so a payload can state one and get an array.\n   */\n  multiple?: true;\n  options?: SetupFieldOption[];\n  constraints?: SetupFieldConstraints;\n}\n\n/** Keyed by field name, which is what `{{form.<name>}}` resolves against. */\nexport type SetupFormFields = Record<string, SetupFormField>;\n\nexport interface SetupForm {\n  note?: string;\n  /** Inputs that decide when the automation runs, keyed by trigger kind. */\n  triggers?: Partial<Record<SetupTriggerKind, SetupFormFields>>;\n  /** Every other input: the arguments to the automation itself. */\n  args: SetupFormFields;\n}\n\n/** A config.json leaf: templated string, number, boolean, null, or a nesting. */\nexport type SetupBundleConfigValue =\n  | string\n  | number\n  | boolean\n  | null\n  | SetupBundleConfigValue[]\n  | { [key: string]: SetupBundleConfigValue };\n\n/**\n * The name the rendered configuration is packed under, which is therefore a\n * name a bundle's own files may not claim. Stated here rather than beside the\n * packing, so admission can refuse the collision without importing it.\n */\nexport const BUNDLE_CONFIG_FILENAME = \"config.json\";\n\n/**\n * The script tarball a direct entry may ship instead of a prompt, for an\n * automation that is deterministic machinery rather than judgement.\n *\n * `files` maps a path inside the archive to the repository path the extensions\n * package read it from; the contents themselves come from that package's\n * `getAutomationBundleFiles`, because this host has the package and not the\n * repository.\n */\nexport interface SetupBundle {\n  /** Provenance recorded on the created automation, alongside the entry id. */\n  version: string;\n  /** The command the service runs inside the extracted tarball. */\n  entrypoint: string;\n  /** Script run once before the entrypoint. Absent when nothing to install. */\n  setupScript?: string;\n  /** Seconds a run may take, when the service default is not enough. */\n  timeout?: number;\n  files: Record<string, string>;\n  /** Rendered from the form and packed as config.json. */\n  config: Record<string, SetupBundleConfigValue>;\n}\n\nexport interface SetupBlock {\n  version: typeof SETUP_VERSION;\n  mode: SetupMode;\n  form: SetupForm;\n  /** direct only. What the automation is told to do. */\n  prompt?: string;\n  /** direct only, and the alternative to `prompt`. Exactly one is present. */\n  bundle?: SetupBundle;\n  /** direct only, event trigger only. Which delivered events belong to it. */\n  filter?: string;\n  /**\n   * Setup context for the conversation that finishes setup. Required for\n   * assisted mode. Optional for direct mode, where it seeds the fallback\n   * conversation offered when the deployment cannot run the direct path.\n   */\n  message?: string;\n}\n\nexport interface SetupIntegrationRequirement {\n  /** Why this entry needs the integration. */\n  message: string;\n  /** Defaults to true. `false` lets setup continue while it is unconnected. */\n  required?: false;\n}\n\nexport interface SetupPrerequisites {\n  /** Keyed by integration catalog id. */\n  integrations: Record<string, SetupIntegrationRequirement>;\n  /** Deployment capabilities this entry cannot run without. */\n  features?: string[];\n}\n\n/**\n * The part of a catalog entry this host reads. An admitted entry always has a\n * `setup` block; entries without one are simply not setup entries.\n */\nexport interface SetupEntry {\n  id: string;\n  name: string;\n  description: string;\n  /**\n   * Version of the template this entry publishes, sent with the create request\n   * as provenance. A bundle declares its own at `setup.bundle.version`; a\n   * prompt entry declares it here. Absent means the entry sends none, so the\n   * service records no template for what it creates.\n   */\n  version?: string;\n  requires: SetupPrerequisites;\n  /** The skill that owns the launch command. Defaults to `id`. */\n  skill?: string;\n  setup: SetupBlock;\n}\n\nexport type SetupPayloadValue =\n  | string\n  | number\n  | boolean\n  | null\n  | SetupPayloadValue[]\n  | { [key: string]: SetupPayloadValue };\n\nexport interface SetupRequestBody {\n  [key: string]: SetupPayloadValue;\n}\n\n/**\n * Form values as collected; the payload mapping shapes them.\n *\n * A field collecting several values holds a list. Everything else holds a\n * string, including fields whose value is a number to the service - the\n * payload mapping is where a value stops being what was typed.\n */\nexport type SetupFormValue = string | string[];\nexport type SetupFormValues = Record<string, SetupFormValue>;\n\n/** `GET /v1/capabilities` — what this deployment supports. */\nexport interface DeploymentCapabilities {\n  ready: boolean;\n  /** Absolute timeout ceiling enforced by this deployment's automation API. */\n  maxAutomationTimeoutSeconds?: number;\n  triggerKinds: string[];\n  eventSources: string[];\n  eventTypes: string[];\n  triggers: {\n    cron?: { minIntervalSeconds: number; timezones: string[] };\n    event?: { filterLanguage: string; filterFunctions: string[] };\n  };\n  features: string[];\n}\n\n/** A single problem with a draft, addressed to the field that caused it. */\nexport interface DraftValidationError {\n  /** Dotted path into the draft. Null when the problem spans the whole draft. */\n  field: string | null;\n  code: string;\n  message: string;\n}\n\n/** `POST /v1/validate` — an invalid draft is still a 200. */\nexport interface ValidateDraftResponse {\n  valid: boolean;\n  errors: DraftValidationError[];\n  sampleEventMatched?: boolean | null;\n}\n\n/**\n * Host-owned shape of the production Automation interface manifest, published\n * by `@openhands/extensions/automations` as `AUTOMATION_INTERFACE`.\n *\n * The catalog states what varies per automation; this states the domain-level\n * facts of the interface itself. As with setup entries, the published data is\n * validated at admission rather than trusted, and a package that predates the\n * manifest simply leaves the host on its own defaults.\n */\n\nexport const INTERFACE_VERSION = \"1.0\";\n\n/** The closed set of runtime-model properties a client may offer for setting. */\nexport type AutomationAttributeName =\n  | \"name\"\n  | \"prompt\"\n  | \"model\"\n  | \"timeout\"\n  | \"schedule\";\n\nexport type InterfaceAttributeType =\n  | \"text\"\n  | \"textarea\"\n  | \"number\"\n  | \"llm-profile\"\n  | \"schedule\";\n\n/** How one settable attribute of an existing Automation is offered. */\nexport interface InterfaceAttribute {\n  type: InterfaceAttributeType;\n  label: string;\n  help?: string;\n  required: boolean;\n  /** Only a `number` attribute carries constraints. */\n  constraints?: { min?: number; max?: number };\n}\n\nexport interface InterfaceRoutes {\n  list: string;\n  /** Carries the `:automationId` segment the host substitutes. */\n  setup: string;\n  /** Carries the `:automationId` segment the host substitutes. */\n  detail: string;\n  /** The templates sub-page. Static: there is no parameter to substitute. */\n  templates?: string;\n}\n\n/**\n * Service-relative paths the host calls. The base path, methods, headers, and\n * auth remain the host's. `{id}` marks where the automation id is substituted.\n */\nexport interface InterfaceEndpoints {\n  list: string;\n  detail: string;\n  dispatch: string;\n  runs: string;\n  tarball: string;\n  health: string;\n  capabilities: string;\n  validate: string;\n  createPrompt: string;\n  createPlugin: string;\n  /**\n   * The raw create endpoint, which a bundle entry is created through, and\n   * where its tarball is uploaded first. Optional: a manifest published before\n   * bundles existed declares neither, and is still admitted.\n   */\n  createBundle?: string;\n  uploads?: string;\n}\n\nexport type InterfaceEndpointName = keyof InterfaceEndpoints;\n\nexport interface InterfaceImportExport {\n  fileKind: string;\n  fileVersion: number;\n  filenameSuffix: string;\n  importDefaults: {\n    /** Provider inferred for short owner/repo repository URLs on import. */\n    repoProvider: SetupGitProvider;\n    /** Event source of the placeholder trigger that keeps an import inert. */\n    placeholderEventSource: string;\n  };\n}\n\n/**\n * The sub-page surface: navigation, overview tiles, filters, sort, and run\n * insights for the list page, and a templates page. Every value below names\n * something this host implements from a closed set — a metric it computes, a\n * predicate it applies, a comparator it runs, an icon it ships — and the\n * manifest picks and captions it, never defines it. The host carries no\n * definitions of its own for this surface, so a manifest without it simply\n * leaves the sub-pages unrendered.\n */\n\nexport const INTERFACE_SUB_PAGE_IDS = [\"list\", \"templates\"] as const;\n\nexport type InterfaceSubPageId = (typeof INTERFACE_SUB_PAGE_IDS)[number];\n\n/** Icon names this host maps to artwork. A manifest cannot supply its own. */\nexport const INTERFACE_ICON_SLUGS = [\n  \"layout-dashboard\",\n  \"sparkles\",\n  \"library\",\n  \"bot\",\n  \"circle-alert\",\n  \"activity\",\n  \"timer\",\n] as const;\n\nexport type InterfaceIconSlug = (typeof INTERFACE_ICON_SLUGS)[number];\n\nexport interface InterfaceSubPageNavItem {\n  /** The `pages` entry this item navigates to; its route comes from `routes`. */\n  page: InterfaceSubPageId;\n  label: string;\n  icon: InterfaceIconSlug;\n}\n\n/** Values this host computes over the loaded automations and their runs. */\nexport const OVERVIEW_METRICS = [\n  \"automations\",\n  \"needs-attention\",\n  \"total-runs\",\n  \"average-duration\",\n] as const;\n\nexport type OverviewMetric = (typeof OVERVIEW_METRICS)[number];\n\n/**\n * Placeholder names a tile's `detail`/`zeroDetail` copy may reference inside\n * `{{...}}`, per metric. Plain substitution, like setup copy.\n */\nexport const OVERVIEW_TILE_PLACEHOLDERS: Record<\n  OverviewMetric,\n  readonly string[]\n> = {\n  automations: [\"active\"],\n  \"needs-attention\": [],\n  \"total-runs\": [],\n  \"average-duration\": [],\n};\n\nexport interface InterfaceOverviewTile {\n  metric: OverviewMetric;\n  label: string;\n  /** Caption under the value. */\n  detail: string;\n  /** Replaces `detail` while the metric's value is zero. */\n  zeroDetail?: string;\n  icon: InterfaceIconSlug;\n}\n\nexport interface InterfaceOverview {\n  /** Names the tiles section for assistive technology. */\n  label: string;\n  tiles: InterfaceOverviewTile[];\n}\n\n/** Filter values name predicates this host implements, per filter id. */\nexport const DASHBOARD_FILTER_VALUES = {\n  status: [\"all\", \"active\", \"failing\", \"disabled\"],\n  trigger: [\"all\", \"schedule\", \"event\"],\n} as const;\n\nexport type DashboardFilterId = keyof typeof DASHBOARD_FILTER_VALUES;\n\nexport const DASHBOARD_FILTER_IDS = Object.keys(\n  DASHBOARD_FILTER_VALUES,\n) as readonly DashboardFilterId[];\n\nexport type DashboardStatusValue =\n  (typeof DASHBOARD_FILTER_VALUES.status)[number];\n\nexport type DashboardTriggerValue =\n  (typeof DASHBOARD_FILTER_VALUES.trigger)[number];\n\nexport interface InterfaceStatusFilter {\n  id: \"status\";\n  /** The control's accessible name. */\n  label: string;\n  options: { value: DashboardStatusValue; label: string }[];\n}\n\nexport interface InterfaceTriggerFilter {\n  id: \"trigger\";\n  /** The control's accessible name. */\n  label: string;\n  options: { value: DashboardTriggerValue; label: string }[];\n}\n\nexport type InterfaceDashboardFilter =\n  | InterfaceStatusFilter\n  | InterfaceTriggerFilter;\n\n/** Sort values name comparators this host implements. */\nexport const DASHBOARD_SORT_VALUES = [\"last-run\", \"runs\", \"name\"] as const;\n\nexport type DashboardSortValue = (typeof DASHBOARD_SORT_VALUES)[number];\n\nexport interface InterfaceDashboardSort {\n  /** The control's accessible name. */\n  label: string;\n  options: { value: DashboardSortValue; label: string }[];\n  /** One of the declared option values. */\n  default: DashboardSortValue;\n}\n\n/**\n * Copy for the per-automation run insights on cards and rows. The states,\n * precedence, sampling, and value formatting are this host's; the manifest\n * names them.\n */\nexport interface InterfaceListInsights {\n  health: {\n    healthy: string;\n    failing: string;\n    running: string;\n    disabled: string;\n    neverRun: string;\n    checking: string;\n  };\n  lastRun: { label: string; never: string; justNow: string };\n  stats: { runs: string; recentSuccess: string; averageDuration: string };\n}\n\n/**\n * The templates sub-page identity. Its body — the catalog cards and their\n * launch behavior — is this host's existing catalog surface.\n */\nexport interface InterfaceTemplatesPage {\n  title: string;\n  description: string;\n}\n\nexport interface InterfaceManifest {\n  version: typeof INTERFACE_VERSION;\n  routes: InterfaceRoutes;\n  navigation: {\n    sidebar: { label: string };\n    commandMenu: { title: string; description: string; keywords: string };\n    /** The ordered sub-page navigation of the interface. */\n    subPages?: InterfaceSubPageNavItem[];\n  };\n  pages: {\n    list: {\n      title: string;\n      subtitle: string;\n      overview?: InterfaceOverview;\n      /** The filter dropdowns of the list page, in render order. */\n      filters?: InterfaceDashboardFilter[];\n      sort?: InterfaceDashboardSort;\n      insights?: InterfaceListInsights;\n    };\n    detail: { backLabel: string };\n    edit: { title: string };\n    templates?: InterfaceTemplatesPage;\n  };\n  docsUrl: string;\n  /**\n   * The input surface of an existing Automation, keyed by the runtime-model\n   * property the host sends. Rendering it as an edit dialog is this host's\n   * choice, not stated here.\n   */\n  attributes: Partial<Record<AutomationAttributeName, InterfaceAttribute>>;\n  importExport: InterfaceImportExport;\n  endpoints: InterfaceEndpoints;\n  featuredAutomationIds: string[];\n  responderIntegrationIds: string[];\n}\n"],"mappings":";AA6BA,IAAa,IAA+B,CAAC,QAAQ,YAAY,GA4DpD,IAAyB,eAiOzB,IAAyB,CAAC,QAAQ,WAAW,GAK7C,IAAuB;CAClC;CACA;CACA;CACA;CACA;CACA;CACA;AACF,GAYa,IAAmB;CAC9B;CACA;CACA;CACA;AACF,GAQa,IAGT;CACF,aAAa,CAAC,QAAQ;CACtB,mBAAmB,CAAC;CACpB,cAAc,CAAC;CACf,oBAAoB,CAAC;AACvB,GAmBa,IAA0B;CACrC,QAAQ;EAAC;EAAO;EAAU;EAAW;CAAU;CAC/C,SAAS;EAAC;EAAO;EAAY;CAAO;AACtC,GAIa,IAAuB,OAAO,KACzC,CACF,GA2Ba,IAAwB;CAAC;CAAY;CAAQ;AAAM"}
+{"version":3,"file":"types.js","names":[],"sources":["../../src/manifests/types.ts"],"sourcesContent":["/**\n * Host-owned shape of an extension-authored setup experience.\n *\n * A catalog entry is declarative data published by `@openhands/extensions`. Its\n * optional `setup` block says what to ask a user for; everything derivable from\n * that — the request to send, the route, the review screen, the analytics — is\n * this host's to generate, so none of it appears here.\n *\n * The names mirror `@openhands/extensions/automations`' own declarations, so an\n * entry from the published package assigns without an adapter.\n */\n\nexport const SETUP_VERSION = \"1.0\";\n\nexport type SetupMode = \"direct\" | \"assisted\";\n\nexport type SetupFieldType =\n  | \"text\"\n  | \"textarea\"\n  | \"select\"\n  | \"number\"\n  | \"cron\"\n  | \"timezone\"\n  | \"repo-picker\"\n  | \"llm-profile\"\n  | \"event-source\"\n  | \"event-type\"\n  | \"plugin-sources\"\n  | \"tarball-upload\";\n\nexport type SetupGitProvider = \"github\" | \"gitlab\" | \"bitbucket\";\n\nexport type SetupTriggerKind = \"cron\" | \"event\";\n\n/** Placeholder namespaces a setup block may reference inside `{{...}}`. */\nexport const SETUP_PLACEHOLDER_NAMESPACES = [\"form\", \"automation\"] as const;\n\nexport interface SetupFieldOption {\n  value: string;\n  label: string;\n}\n\nexport interface SetupFieldConstraints {\n  minLength?: number;\n  maxLength?: number;\n  min?: number;\n  max?: number;\n  /**\n   * A host-implemented check named from a closed set. Entries supply no regex\n   * of their own, so they cannot hand the host a pathological pattern.\n   */\n  format?: \"safeExpressionLiteral\";\n}\n\nexport interface SetupFormField {\n  type: SetupFieldType;\n  label: string;\n  help: string;\n  placeholder?: string;\n  default?: string | number | boolean | null;\n  required: boolean;\n  provider?: SetupGitProvider;\n  /**\n   * repo-picker only. The field collects several repositories rather than one,\n   * and its value is a list. A placeholder that is the whole value resolves to\n   * that list, so a payload can state one and get an array.\n   */\n  multiple?: true;\n  options?: SetupFieldOption[];\n  constraints?: SetupFieldConstraints;\n}\n\n/** Keyed by field name, which is what `{{form.<name>}}` resolves against. */\nexport type SetupFormFields = Record<string, SetupFormField>;\n\nexport interface SetupForm {\n  note?: string;\n  /** Inputs that decide when the automation runs, keyed by trigger kind. Multiple keys are selectable variants. */\n  triggers?: Partial<Record<SetupTriggerKind, SetupFormFields>>;\n  /** Every other input: the arguments to the automation itself. */\n  args: SetupFormFields;\n}\n\n/** A config.json leaf: templated string, number, boolean, null, or a nesting. */\nexport type SetupBundleConfigValue =\n  | string\n  | number\n  | boolean\n  | null\n  | SetupBundleConfigValue[]\n  | { [key: string]: SetupBundleConfigValue };\n\n/**\n * The name the rendered configuration is packed under, which is therefore a\n * name a bundle's own files may not claim. Stated here rather than beside the\n * packing, so admission can refuse the collision without importing it.\n */\nexport const BUNDLE_CONFIG_FILENAME = \"config.json\";\n\n/**\n * The script tarball a direct entry may ship instead of a prompt, for an\n * automation that is deterministic machinery rather than judgement.\n *\n * `files` maps a path inside the archive to the repository path the extensions\n * package read it from; the contents themselves come from that package's\n * `getAutomationBundleFiles`, because this host has the package and not the\n * repository.\n */\nexport interface SetupBundle {\n  /** Provenance recorded on the created automation, alongside the entry id. */\n  version: string;\n  /** The command the service runs inside the extracted tarball. */\n  entrypoint: string;\n  /** Script run once before the entrypoint. Absent when nothing to install. */\n  setupScript?: string;\n  /** Seconds a run may take, when the service default is not enough. */\n  timeout?: number;\n  files: Record<string, string>;\n  /** Rendered from the form and packed as config.json. */\n  config: Record<string, SetupBundleConfigValue>;\n}\n\nexport type SetupActionKind = \"prompt\" | \"plugin\" | \"upload\";\n\nexport interface SetupPromptAction {\n  label: string;\n  help: string;\n  features: string[];\n  args: SetupFormFields;\n  prompt: string;\n}\n\nexport interface SetupPluginAction {\n  label: string;\n  help: string;\n  features: string[];\n  args: SetupFormFields;\n  prompt: string;\n  plugins: string;\n}\n\nexport interface SetupUploadAction {\n  label: string;\n  help: string;\n  features: string[];\n  args: SetupFormFields;\n  tarballPath: string;\n  entrypoint: string;\n  setupScript?: string;\n}\n\nexport interface SetupActions {\n  prompt?: SetupPromptAction;\n  plugin?: SetupPluginAction;\n  upload?: SetupUploadAction;\n}\n\nexport type SetupAction =\n  | SetupPromptAction\n  | SetupPluginAction\n  | SetupUploadAction;\n\nexport interface SetupBlock {\n  version: typeof SETUP_VERSION;\n  mode: SetupMode;\n  form: SetupForm;\n  /** direct only. What the automation is told to do. */\n  prompt?: string;\n  /** direct only, and the alternative to `prompt`. Exactly one is present. */\n  bundle?: SetupBundle;\n  /** direct only, and the alternative to `prompt` or `bundle`. */\n  actions?: SetupActions;\n  /** direct only, event trigger only. Which delivered events belong to it. */\n  filter?: string;\n  /**\n   * Setup context for the conversation that finishes setup. Required for\n   * assisted mode. Optional for direct mode, where it seeds the fallback\n   * conversation offered when the deployment cannot run the direct path.\n   */\n  message?: string;\n}\n\nexport interface SetupIntegrationRequirement {\n  /** Why this entry needs the integration. */\n  message: string;\n  /** Defaults to true. `false` lets setup continue while it is unconnected. */\n  required?: false;\n}\n\nexport interface SetupPrerequisites {\n  /** Keyed by integration catalog id. */\n  integrations: Record<string, SetupIntegrationRequirement>;\n  /** Deployment capabilities this entry cannot run without. */\n  features?: string[];\n}\n\n/**\n * The part of a catalog entry this host reads. An admitted entry always has a\n * `setup` block; entries without one are simply not setup entries.\n */\nexport interface SetupEntry {\n  id: string;\n  name: string;\n  description: string;\n  /**\n   * Version of the template this entry publishes, sent with the create request\n   * as provenance. A bundle declares its own at `setup.bundle.version`; a\n   * prompt entry declares it here. Absent means the entry sends none, so the\n   * service records no template for what it creates.\n   */\n  version?: string;\n  requires: SetupPrerequisites;\n  /** The skill that owns the launch command. Defaults to `id`. */\n  skill?: string;\n  setup: SetupBlock;\n}\n\nexport type SetupPayloadValue =\n  | string\n  | number\n  | boolean\n  | null\n  | SetupPayloadValue[]\n  | { [key: string]: SetupPayloadValue };\n\nexport interface SetupRequestBody {\n  [key: string]: SetupPayloadValue;\n}\n\n/**\n * Form values as collected; the payload mapping shapes them.\n *\n * A field collecting several values holds a list. Everything else holds a\n * string, including fields whose value is a number to the service - the\n * payload mapping is where a value stops being what was typed.\n */\nexport type SetupFormValue = string | number | boolean | null | string[] | File;\nexport type SetupFormValues = Record<string, SetupFormValue>;\n\n/** `GET /v1/capabilities` — what this deployment supports. */\nexport interface DeploymentCapabilities {\n  ready: boolean;\n  /** Absolute timeout ceiling enforced by this deployment's automation API. */\n  maxAutomationTimeoutSeconds?: number;\n  triggerKinds: string[];\n  eventSources: string[];\n  eventTypes: string[];\n  triggers: {\n    cron?: { minIntervalSeconds: number; timezones: string[] };\n    event?: { filterLanguage: string; filterFunctions: string[] };\n  };\n  features: string[];\n}\n\n/** A single problem with a draft, addressed to the field that caused it. */\nexport interface DraftValidationError {\n  /** Dotted path into the draft. Null when the problem spans the whole draft. */\n  field: string | null;\n  code: string;\n  message: string;\n}\n\n/** `POST /v1/validate` — an invalid draft is still a 200. */\nexport interface ValidateDraftResponse {\n  valid: boolean;\n  errors: DraftValidationError[];\n  sampleEventMatched?: boolean | null;\n}\n\n/**\n * Host-owned shape of the production Automation interface manifest, published\n * by `@openhands/extensions/automations` as `AUTOMATION_INTERFACE`.\n *\n * The catalog states what varies per automation; this states the domain-level\n * facts of the interface itself. As with setup entries, the published data is\n * validated at admission rather than trusted, and a package that predates the\n * manifest simply leaves the host on its own defaults.\n */\n\nexport const INTERFACE_VERSION = \"1.0\";\n\n/** The closed set of runtime-model properties a client may offer for setting. */\nexport type AutomationAttributeName =\n  | \"name\"\n  | \"prompt\"\n  | \"model\"\n  | \"timeout\"\n  | \"schedule\";\n\nexport type InterfaceAttributeType =\n  | \"text\"\n  | \"textarea\"\n  | \"number\"\n  | \"llm-profile\"\n  | \"schedule\";\n\n/** How one settable attribute of an existing Automation is offered. */\nexport interface InterfaceAttribute {\n  type: InterfaceAttributeType;\n  label: string;\n  help?: string;\n  required: boolean;\n  /** Only a `number` attribute carries constraints. */\n  constraints?: { min?: number; max?: number };\n}\n\nexport interface InterfaceRoutes {\n  list: string;\n  /** Carries the `:automationId` segment the host substitutes. */\n  setup: string;\n  /** Carries the `:automationId` segment the host substitutes. */\n  detail: string;\n  /** The templates sub-page. Static: there is no parameter to substitute. */\n  templates?: string;\n}\n\n/**\n * Service-relative paths the host calls. The base path, methods, headers, and\n * auth remain the host's. `{id}` marks where the automation id is substituted.\n */\nexport interface InterfaceEndpoints {\n  list: string;\n  detail: string;\n  dispatch: string;\n  runs: string;\n  tarball: string;\n  health: string;\n  capabilities: string;\n  validate: string;\n  createPrompt: string;\n  createPlugin: string;\n  /**\n   * The raw create endpoint, which a bundle entry is created through, and\n   * where its tarball is uploaded first. Optional: a manifest published before\n   * bundles existed declares neither, and is still admitted.\n   */\n  createBundle?: string;\n  uploads?: string;\n}\n\nexport type InterfaceEndpointName = keyof InterfaceEndpoints;\n\nexport interface InterfaceImportExport {\n  fileKind: string;\n  fileVersion: number;\n  filenameSuffix: string;\n  importDefaults: {\n    /** Provider inferred for short owner/repo repository URLs on import. */\n    repoProvider: SetupGitProvider;\n    /** Event source of the placeholder trigger that keeps an import inert. */\n    placeholderEventSource: string;\n  };\n}\n\n/**\n * The sub-page surface: navigation, overview tiles, filters, sort, and run\n * insights for the list page, and a templates page. Every value below names\n * something this host implements from a closed set — a metric it computes, a\n * predicate it applies, a comparator it runs, an icon it ships — and the\n * manifest picks and captions it, never defines it. The host carries no\n * definitions of its own for this surface, so a manifest without it simply\n * leaves the sub-pages unrendered.\n */\n\nexport const INTERFACE_SUB_PAGE_IDS = [\"list\", \"templates\"] as const;\n\nexport type InterfaceSubPageId = (typeof INTERFACE_SUB_PAGE_IDS)[number];\n\n/** Icon names this host maps to artwork. A manifest cannot supply its own. */\nexport const INTERFACE_ICON_SLUGS = [\n  \"layout-dashboard\",\n  \"sparkles\",\n  \"library\",\n  \"bot\",\n  \"circle-alert\",\n  \"activity\",\n  \"timer\",\n] as const;\n\nexport type InterfaceIconSlug = (typeof INTERFACE_ICON_SLUGS)[number];\n\nexport interface InterfaceSubPageNavItem {\n  /** The `pages` entry this item navigates to; its route comes from `routes`. */\n  page: InterfaceSubPageId;\n  label: string;\n  icon: InterfaceIconSlug;\n}\n\n/** Values this host computes over the loaded automations and their runs. */\nexport const OVERVIEW_METRICS = [\n  \"automations\",\n  \"needs-attention\",\n  \"total-runs\",\n  \"average-duration\",\n] as const;\n\nexport type OverviewMetric = (typeof OVERVIEW_METRICS)[number];\n\n/**\n * Placeholder names a tile's `detail`/`zeroDetail` copy may reference inside\n * `{{...}}`, per metric. Plain substitution, like setup copy.\n */\nexport const OVERVIEW_TILE_PLACEHOLDERS: Record<\n  OverviewMetric,\n  readonly string[]\n> = {\n  automations: [\"active\"],\n  \"needs-attention\": [],\n  \"total-runs\": [],\n  \"average-duration\": [],\n};\n\nexport interface InterfaceOverviewTile {\n  metric: OverviewMetric;\n  label: string;\n  /** Caption under the value. */\n  detail: string;\n  /** Replaces `detail` while the metric's value is zero. */\n  zeroDetail?: string;\n  icon: InterfaceIconSlug;\n}\n\nexport interface InterfaceOverview {\n  /** Names the tiles section for assistive technology. */\n  label: string;\n  tiles: InterfaceOverviewTile[];\n}\n\n/** Filter values name predicates this host implements, per filter id. */\nexport const DASHBOARD_FILTER_VALUES = {\n  status: [\"all\", \"active\", \"failing\", \"disabled\"],\n  trigger: [\"all\", \"schedule\", \"event\"],\n} as const;\n\nexport type DashboardFilterId = keyof typeof DASHBOARD_FILTER_VALUES;\n\nexport const DASHBOARD_FILTER_IDS = Object.keys(\n  DASHBOARD_FILTER_VALUES,\n) as readonly DashboardFilterId[];\n\nexport type DashboardStatusValue =\n  (typeof DASHBOARD_FILTER_VALUES.status)[number];\n\nexport type DashboardTriggerValue =\n  (typeof DASHBOARD_FILTER_VALUES.trigger)[number];\n\nexport interface InterfaceStatusFilter {\n  id: \"status\";\n  /** The control's accessible name. */\n  label: string;\n  options: { value: DashboardStatusValue; label: string }[];\n}\n\nexport interface InterfaceTriggerFilter {\n  id: \"trigger\";\n  /** The control's accessible name. */\n  label: string;\n  options: { value: DashboardTriggerValue; label: string }[];\n}\n\nexport type InterfaceDashboardFilter =\n  | InterfaceStatusFilter\n  | InterfaceTriggerFilter;\n\n/** Sort values name comparators this host implements. */\nexport const DASHBOARD_SORT_VALUES = [\"last-run\", \"runs\", \"name\"] as const;\n\nexport type DashboardSortValue = (typeof DASHBOARD_SORT_VALUES)[number];\n\nexport interface InterfaceDashboardSort {\n  /** The control's accessible name. */\n  label: string;\n  options: { value: DashboardSortValue; label: string }[];\n  /** One of the declared option values. */\n  default: DashboardSortValue;\n}\n\n/**\n * Copy for the per-automation run insights on cards and rows. The states,\n * precedence, sampling, and value formatting are this host's; the manifest\n * names them.\n */\nexport interface InterfaceListInsights {\n  health: {\n    healthy: string;\n    failing: string;\n    running: string;\n    disabled: string;\n    neverRun: string;\n    checking: string;\n  };\n  lastRun: { label: string; never: string; justNow: string };\n  stats: { runs: string; recentSuccess: string; averageDuration: string };\n}\n\n/**\n * The templates sub-page identity. Its body — the catalog cards and their\n * launch behavior — is this host's existing catalog surface.\n */\nexport interface InterfaceTemplatesPage {\n  title: string;\n  description: string;\n}\n\nexport interface InterfaceManifest {\n  version: typeof INTERFACE_VERSION;\n  routes: InterfaceRoutes;\n  navigation: {\n    sidebar: { label: string };\n    commandMenu: { title: string; description: string; keywords: string };\n    /** The ordered sub-page navigation of the interface. */\n    subPages?: InterfaceSubPageNavItem[];\n  };\n  pages: {\n    list: {\n      title: string;\n      subtitle: string;\n      overview?: InterfaceOverview;\n      /** The filter dropdowns of the list page, in render order. */\n      filters?: InterfaceDashboardFilter[];\n      sort?: InterfaceDashboardSort;\n      insights?: InterfaceListInsights;\n    };\n    detail: { backLabel: string };\n    edit: { title: string };\n    templates?: InterfaceTemplatesPage;\n  };\n  docsUrl: string;\n  /**\n   * The input surface of an existing Automation, keyed by the runtime-model\n   * property the host sends. Rendering it as an edit dialog is this host's\n   * choice, not stated here.\n   */\n  attributes: Partial<Record<AutomationAttributeName, InterfaceAttribute>>;\n  importExport: InterfaceImportExport;\n  endpoints: InterfaceEndpoints;\n  featuredAutomationIds: string[];\n  responderIntegrationIds: string[];\n}\n"],"mappings":";AAmCA,IAAa,IAA+B,CAAC,QAAQ,YAAY,GA8DpD,IAAyB,eA2QzB,IAAyB,CAAC,QAAQ,WAAW,GAK7C,IAAuB;CAClC;CACA;CACA;CACA;CACA;CACA;CACA;AACF,GAYa,IAAmB;CAC9B;CACA;CACA;CACA;AACF,GAQa,IAGT;CACF,aAAa,CAAC,QAAQ;CACtB,mBAAmB,CAAC;CACpB,cAAc,CAAC;CACf,oBAAoB,CAAC;AACvB,GAmBa,IAA0B;CACrC,QAAQ;EAAC;EAAO;EAAU;EAAW;CAAU;CAC/C,SAAS;EAAC;EAAO;EAAY;CAAO;AACtC,GAIa,IAAuB,OAAO,KACzC,CACF,GA2Ba,IAAwB;CAAC;CAAY;CAAQ;AAAM"}

package/dist/node_modules/@openhands/extensions/automations/bundle-index.cjs

@@ -42,6 +42,12 @@ REPOS = ["owner/repo"]
 TRIGGER_LABEL = "openhands-review"
 REVIEW_TONE = "thorough"
 REVIEW_STYLE_INSTRUCTIONS = ""
+# Path within the checked-out repository to a repo-specific review guide
+# (e.g. the repo's own code-review skill). When the file exists at this path
+# relative to the repo root, its contents are read and injected verbatim into
+# the review prompt so the guide is always applied deterministically, rather
+# than relying on the spawned agent's skill activation. Set to "" to disable.
+REPO_REVIEW_GUIDE_PATH = ".agents/skills/custom-codereview-guide.md"
 DEFAULT_OPENHANDS_URL = "http://localhost:8000"
 
 CONFIG_FILENAME = "config.json"
@@ -54,6 +60,7 @@ _CONFIG_TYPES: dict[str, type] = {
     "trigger_label": str,
     "review_tone": str,
     "review_style_instructions": str,
+    "repo_review_guide_path": str,
     "openhands_url": str,
 }
 
@@ -134,6 +141,7 @@ REPOS = _CONFIG.get("repos", REPOS)
 TRIGGER_LABEL = _CONFIG.get("trigger_label", TRIGGER_LABEL)
 REVIEW_TONE = _CONFIG.get("review_tone", REVIEW_TONE)
 REVIEW_STYLE_INSTRUCTIONS = _CONFIG.get("review_style_instructions", REVIEW_STYLE_INSTRUCTIONS)
+REPO_REVIEW_GUIDE_PATH = _CONFIG.get("repo_review_guide_path", REPO_REVIEW_GUIDE_PATH)
 DEFAULT_OPENHANDS_URL = _CONFIG.get("openhands_url", DEFAULT_OPENHANDS_URL)
 
 DONE_DEBOUNCE = 15
@@ -741,7 +749,28 @@ def _with_ai_disclosure(body: str) -> str:
     return f"{body}\\n\\n{disclosure}" if body else disclosure
 
 
-def _build_review_prompt(repo: str, pr: dict, head_sha: str, label_event: dict) -> str:
+def _load_repo_review_guide(workspace_dir: Path) -> str | None:
+    """Read the repo-specific review guide from the checked-out repository.
+
+    The path is taken from \`\`REPO_REVIEW_GUIDE_PATH\`\`. An empty path disables
+    the feature. Returns the file contents, or None if the file is absent or
+    unreadable — a missing guide is never fatal, the review simply proceeds
+    without it.
+    """
+    if not REPO_REVIEW_GUIDE_PATH:
+        return None
+    candidate = workspace_dir / REPO_REVIEW_GUIDE_PATH
+    try:
+        if candidate.is_file():
+            text = candidate.read_text(encoding="utf-8", errors="replace").strip()
+            if text:
+                return text
+    except Exception as exc:
+        print(f"  Warning: could not read repo review guide {candidate}: {exc}")
+    return None
+
+
+def _build_review_prompt(repo: str, pr: dict, head_sha: str, label_event: dict, repo_review_guide: str | None = None) -> str:
     number = pr.get("number", "?")
     title = pr.get("title", "(no title)")
     body = (pr.get("body") or "").strip() or "(no description)"
@@ -757,6 +786,10 @@ def _build_review_prompt(repo: str, pr: dict, head_sha: str, label_event: dict)
     deletions = pr.get("deletions", "?")
     tone = _TONE_INSTRUCTIONS.get(REVIEW_TONE, _TONE_INSTRUCTIONS["thorough"])
     extra = f"\\n\\nAdditional style instructions:\\n{REVIEW_STYLE_INSTRUCTIONS}" if REVIEW_STYLE_INSTRUCTIONS.strip() else ""
+    guide_section = (
+        f"\\n\\nRepo-specific review guide (from {REPO_REVIEW_GUIDE_PATH}):\\n---\\n{repo_review_guide}\\n---\\n"
+        if repo_review_guide else ""
+    )
 
     return (
         "You are an AI code reviewer. Review the GitHub pull request below and publish "
@@ -775,7 +808,12 @@ def _build_review_prompt(repo: str, pr: dict, head_sha: str, label_event: dict)
         "Required workflow:\\n"
         "1. The workspace is already the repository root at the exact Head SHA above. "
         "Do not clone, fetch, check out, or delete the repository.\\n"
-        "2. Inspect the PR discussion, existing review comments, changed files, and the diff, "
+        "2. Before reviewing, you MUST read the repository's own guidance to understand the repo first.\\n"
+        "   Read \`AGENTS.md\` at the repository root (and any nested \`AGENTS.md\` covering the "
+        "changed files), plus other relevant docs when present - e.g. \`CONTRIBUTING.md\`, "
+        "\`CLAUDE.md\`, \`.cursorrules\`, and any review or coding-guideline docs. Apply that "
+        "guidance to your review.\\n"
+        "   Then inspect the PR discussion, existing review comments, changed files, and the diff, "
         "together with the surrounding code in the workspace.\\n"
         "   Use \`gh\` or GitHub REST API calls with \`GITHUB_PERSONAL_ACCESS_TOKEN\`; never print secret values.\\n"
         "3. Ground every finding in the workspace code. Before using an inline location, verify that "
@@ -793,7 +831,7 @@ def _build_review_prompt(repo: str, pr: dict, head_sha: str, label_event: dict)
         "or \`🔄 CHANGES REQUESTED\`.\\n"
         "8. If there are no material issues, still publish a review saying so, with the "
         "disclosure and the verdict.\\n"
-        f"\\nReview instructions:\\n{tone}{extra}\\n\\n"
+        f"\\nReview instructions:\\n{tone}{extra}{guide_section}\\n\\n"
         "After GitHub accepts the review, output exactly \`GITHUB_REVIEW_POSTED\`. "
         "If publishing still fails after the fallback in step 5, output the complete review text "
         "so it can be posted as a comment instead."
@@ -841,7 +879,10 @@ def _process_review_request(
     workspace_dir = None
     try:
         workspace_dir = _prepare_repository(github_token, repo, number, head_sha)
-        prompt = _build_review_prompt(repo, pr, head_sha, label_event)
+        repo_review_guide = _load_repo_review_guide(workspace_dir)
+        if repo_review_guide:
+            print(f"  Injected repo review guide for PR #{number}")
+        prompt = _build_review_prompt(repo, pr, head_sha, label_event, repo_review_guide)
         conv_id = create_conversation(agent_url, api_key, prompt, workspace_dir)
     except Exception as exc:
         # The claim is dropped so the next poll retries this label event. The