Function createPluginToolset

Parameters

• descriptor: {
      configFileName: string;
      configSchema: ZodType<
          unknown,
          unknown,
          $ZodTypeInternals<unknown, unknown>,
      >;
      customCliCommands?: $InferOuterFunctionType<
          ZodTuple<
              readonly [ZodCustom<Command<[], {}, {}>, Command<[], {}, {}>>],
              null,
          >,
          ZodVoid,
      >;
      customMerge?: $InferOuterFunctionType<
          ZodTuple<
              readonly [
                  ZodRecord<ZodString, ZodUnknown>,
                  ZodRecord<ZodString, ZodUnknown>,
              ],
              null,
          >,
          ZodRecord<ZodString, ZodUnknown>,
      >;
      customPluginTools?: $InferOuterFunctionType<
          ZodTuple<readonly [ZodCustom<PluginApi, PluginApi>], null>,
          ZodArray<ZodUnknown>,
      >;
      defaultPort: number;
      initTemplate: $InferOuterFunctionType<
          ZodTuple<readonly [], null>,
          ZodRecord<ZodString, ZodUnknown>,
      >;
      name: string;
      onConfigApply?: $InferOuterFunctionType<
          ZodTuple<readonly [ZodRecord<ZodString, ZodUnknown>], null>,
          ZodPromise<ZodVoid>,
      >;
      pluginPackage: string;
      run: $InferOuterFunctionType<
          ZodTuple<readonly [ZodString], null>,
          ZodPromise<ZodVoid>,
      >;
      serviceName?: string;
      servicePackage: string;
      startCommand: $InferOuterFunctionType<
          ZodTuple<readonly [ZodString], null>,
          ZodArray<ZodString>,
      >;
      version: string;
  }

  The component descriptor.

  • configFileName: string

    Config file name (e.g., 'jeeves-watcher.config.json').

  • configSchema: ZodType<unknown, unknown, $ZodTypeInternals<unknown, unknown>>

    Zod schema for validating config files.

  • OptionalcustomCliCommands?: $InferOuterFunctionType<
        ZodTuple<
            readonly [ZodCustom<Command<[], {}, {}>, Command<[], {}, {}>>],
            null,
        >,
        ZodVoid,
    >

    Extension point: add custom CLI commands to the service CLI.

  • OptionalcustomMerge?: $InferOuterFunctionType<
        ZodTuple<
            readonly [
                ZodRecord<ZodString, ZodUnknown>,
                ZodRecord<ZodString, ZodUnknown>,
            ],
            null,
        >,
        ZodRecord<ZodString, ZodUnknown>,
    >

    Custom merge function for config apply. Receives the existing config and the patch, returns the merged result. Optional — if omitted, the default deep-merge (object-recursive, array-replacing) is used.

    Use this to implement domain-specific merge strategies such as name-based array merging for inference rules.

  • OptionalcustomPluginTools?: $InferOuterFunctionType<
        ZodTuple<readonly [ZodCustom<PluginApi, PluginApi>], null>,
        ZodArray<ZodUnknown>,
    >

    Extension point: return additional plugin tool descriptors.

  • defaultPort: number

    Default port for the service's HTTP API.

  • initTemplate: $InferOuterFunctionType<
        ZodTuple<readonly [], null>,
        ZodRecord<ZodString, ZodUnknown>,
    >

    Returns a default config object for init.

  • name: string

    Component name (e.g., 'watcher', 'runner', 'server', 'meta').

  • OptionalonConfigApply?: $InferOuterFunctionType<
        ZodTuple<readonly [ZodRecord<ZodString, ZodUnknown>], null>,
        ZodPromise<ZodVoid>,
    >

    Service-side callback after config apply. Receives the merged, validated config (not the raw patch). Optional — if omitted, write-only (service picks up changes on restart).

  • pluginPackage: string

    npm package name for the plugin.

  • run: $InferOuterFunctionType<
        ZodTuple<readonly [ZodString], null>,
        ZodPromise<ZodVoid>,
    >

    In-process service entry point for the CLI start command.

  • OptionalserviceName?: string

    System service name. Defaults to jeeves-${name} when not provided.

  • servicePackage: string

    npm package name for the service.

  • startCommand: $InferOuterFunctionType<
        ZodTuple<readonly [ZodString], null>,
        ZodArray<ZodString>,
    >

    Returns command + args for launching the service process. Consumed by service install.

  • version: string

    Component version (from package.json).

• options: { apiUrl?: string | PluginApiUrlResolver }

  Tool options (required, so each plugin consciously chooses its service URL). Pass the plugin's apiUrl (string or lazy resolver); with apiUrl unset, the tools call http://127.0.0.1:<defaultPort>.

  • OptionalapiUrl?: string | PluginApiUrlResolver

    Service base URL (e.g. http://127.0.0.1:1936), or a resolver evaluated per tool call. Unset, empty, or a resolver returning undefined falls back to http://127.0.0.1:<defaultPort>.