Skip to content

@codesoul-co/hypha-adapters-local / local-process-sandbox-provider-factory

Using this module

Use the Local process sandbox provider factory module for binding external or local providers to Hypha ports. It exports 1 class, 1 constant, 1 type.

Import from the package entrypoint

ts
import {
  LocalProcessSandboxProviderFactory,
  LOCAL_PROCESS_SANDBOX_PROVIDER_ID,
} from '@codesoul-co/hypha-adapters-local';

import type {
  LocalProcessSandboxProviderFactoryOptions,
} from '@codesoul-co/hypha-adapters-local';

Usage patterns

  • Use the 1 type/interface export as static contracts in application code, adapters, or tests. Import them with import type; they do not exist at runtime.
  • The module exposes 1 class as constructable runtime implementations. Each symbol entry lists its constructor and public methods.
  • The 1 constant/enum export provides stable values, schemas, definitions, or defaults. Reuse these exports instead of copying internal values into an application.

Public exports

SymbolKindSignatureDescription
LocalProcessSandboxProviderFactoryclassnew LocalProcessSandboxProviderFactory(options: LocalProcessSandboxProviderFactoryOptions): LocalProcessSandboxProviderFactoryComposition adapter for the trusted-development Local Process Provider. Registration is explicit. The optional root creation is limited to the configured Workspace boundary; the Provider still resolves and validates the real path and executable identities before running commands.
LOCAL_PROCESS_SANDBOX_PROVIDER_IDconstantconst LOCAL_PROCESS_SANDBOX_PROVIDER_ID: "provider.local-process"LOCAL PROCESS SANDBOX PROVIDER ID constant exported by the local-process-sandbox-provider-factory module.
LocalProcessSandboxProviderFactoryOptionstypetype LocalProcessSandboxProviderFactoryOptions = Omit<LocalProcessExecutionProviderOptions, 'id'> & { providerId?: string; createWorkspaceRoot?: boolean; }Public type alias for Local Process Sandbox Provider Factory Options; the declaration contains its complete type expression.

LocalProcessSandboxProviderFactory

Composition adapter for the trusted-development Local Process Provider. Registration is explicit. The optional root creation is limited to the configured Workspace boundary; the Provider still resolves and validates the real path and executable identities before running commands.

Declaration

text
export declare class LocalProcessSandboxProviderFactory implements SandboxProviderFactory {
    readonly providerType: "local_process";
    readonly providerId: string;
    constructor(options: LocalProcessSandboxProviderFactoryOptions);
    create(): Promise<SandboxProvider>;
}

Public members

MemberKindSignatureDescription
constructorconstructor(options: LocalProcessSandboxProviderFactoryOptions): LocalProcessSandboxProviderFactoryCreates an instance of this class.
createmethodcreate(): Promise<SandboxProvider>Public method; parameters and return type are shown in the signature.
providerIdpropertyreadonly providerId: stringPublic property; its type, readonly modifier and optionality are shown in the signature.
providerTypepropertyreadonly providerType: "local_process"Public property; its type, readonly modifier and optionality are shown in the signature.

LOCAL_PROCESS_SANDBOX_PROVIDER_ID

LOCAL PROCESS SANDBOX PROVIDER ID constant exported by the local-process-sandbox-provider-factory module.

Declaration

text
export declare const LOCAL_PROCESS_SANDBOX_PROVIDER_ID: "provider.local-process";

LocalProcessSandboxProviderFactoryOptions

Public type alias for Local Process Sandbox Provider Factory Options; the declaration contains its complete type expression.

Declaration

text
export type LocalProcessSandboxProviderFactoryOptions = Omit<LocalProcessExecutionProviderOptions, 'id'> & {
    providerId?: string;
    createWorkspaceRoot?: boolean;
};