SharedOS API v0.1.0-alpha.5

---

SharedOS API / @aicoo/sharedos-testkit

@aicoo/sharedos-testkit

Deterministic in-memory fixtures and recording providers for SharedOS tests.

npm install --save-dev @aicoo/sharedos-testkit@next

This package is for tests, examples, and isolated experimental worlds. Its in-memory stores are not durable or multi-instance-safe production storage. InMemoryToolNamespaceSettingsStore can exercise the namespace control plane without becoming a production settings backend.

SharedOS is currently an 0.x prerelease.

Classes

InMemoryAuditSink

Defined in: testkit/src/index.ts:29

Implements

• AuditSink

Constructors

Constructor

new InMemoryAuditSink(): InMemoryAuditSink

Returns

InMemoryAuditSink

Properties

Property	Modifier	Type	Default value	Defined in
<a id="property-events"></a> events	readonly	AuditEvent[]	[]	testkit/src/index.ts:30

Methods

record()

record(event): Promise<void>>

Defined in: testkit/src/index.ts:32

Parameters

Parameter	Type
event	AuditEvent

Returns

Promise<void>

Implementation of

AuditSink.record

---

InMemoryDelegationChainResolver

Defined in: testkit/src/index.ts:136

Namespace-scoped ancestor lookup for delegated-grant fixtures.

Implements

• DelegationChainResolver

Constructors

Constructor

new InMemoryDelegationChainResolver(grants?): InMemoryDelegationChainResolver

Defined in: testkit/src/index.ts:139

Parameters

Parameter	Type	Default value
grants	readonly object[]	[]

Returns

InMemoryDelegationChainResolver

Methods

add()

add(grant): this

Defined in: testkit/src/index.ts:145

Parameters

Parameter	Type
grant	{ capabilities: object[]; constraints: { delegationDepth?: number; expiresAt?: string; maxUses?: number; notBefore?: string; purposes?: string[]; }; id: string; issuedAt: string; issuer: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; metadata?: JsonObject; namespaceId: string; parentGrantId?: string; revokedAt?: string; subject: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; }
grant.capabilities	object[]
grant.constraints	{ delegationDepth?: number; expiresAt?: string; maxUses?: number; notBefore?: string; purposes?: string[]; }
grant.constraints.delegationDepth?	number
grant.constraints.expiresAt?	string
grant.constraints.maxUses?	number
grant.constraints.notBefore?	string
grant.constraints.purposes?	string[]
grant.id	string
grant.issuedAt	string
grant.issuer	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }
grant.metadata?	JsonObject
grant.namespaceId	string
grant.parentGrantId?	string
grant.revokedAt?	string
grant.subject	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }

Returns

this

resolve()

resolve(namespaceId, grantId): Promise<{ capabilities: object[]; constraints: { delegationDepth?: number; expiresAt?: string; maxUses?: number; notBefore?: string; purposes?: string[]; }; id: string; issuedAt: string; issuer: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; metadata?: JsonObject; namespaceId: string; parentGrantId?: string; revokedAt?: string; subject: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; } | undefined>>

Defined in: testkit/src/index.ts:165

Parameters

Parameter	Type
namespaceId	string
grantId	string

Returns

Promise<{ capabilities: object[]; constraints: { delegationDepth?: number; expiresAt?: string; maxUses?: number; notBefore?: string; purposes?: string[]; }; id: string; issuedAt: string; issuer: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; metadata?: JsonObject; namespaceId: string; parentGrantId?: string; revokedAt?: string; subject: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; } | undefined>

Implementation of

DelegationChainResolver.resolve

revoke()

revoke(namespaceId, grantId, revokedAt): this

Defined in: testkit/src/index.ts:156

Record a revocation the way a host grant store would, in place.

Parameters

Parameter	Type
namespaceId	string
grantId	string
revokedAt	string

Returns

this

---

InMemoryGrantSource

Defined in: testkit/src/index.ts:87

A host grant store fixture.

load answers only with grants issued to the context's actor by its authority inside its namespace, which is the contract every production GrantSource must satisfy.

Implements

• GrantSource

Constructors

Constructor

new InMemoryGrantSource(grants?): InMemoryGrantSource

Defined in: testkit/src/index.ts:90

Parameters

Parameter	Type	Default value
grants	readonly object[]	[]

Returns

InMemoryGrantSource

Methods

add()

add(...grants): this

Defined in: testkit/src/index.ts:96

Parameters

Parameter	Type
...grants	readonly object[]

Returns

this

load()

load(context): Promise<readonly object[]>

Defined in: testkit/src/index.ts:114

Parameters

Parameter	Type
context	{ actor: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; authority: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; enabledToolNamespaces: string[]; namespaceId: string; now: string; owner: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; purpose: string; traceId: string; }
context.actor	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }
context.authority	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }
context.enabledToolNamespaces	string[]
context.namespaceId	string
context.now	string
context.owner	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }
context.purpose	string
context.traceId	string

Returns

Promise<readonly object[]>

Implementation of

GrantSource.load

revoke()

revoke(grantId, revokedAt): this

Defined in: testkit/src/index.ts:104

Record a revocation the way a host store would, without deleting history.

Parameters

Parameter	Type
grantId	string
revokedAt	string

Returns

this

---

InMemoryMessageTransport

Defined in: testkit/src/index.ts:37

Implements

• MessageTransport

Constructors

Constructor

new InMemoryMessageTransport(): InMemoryMessageTransport

Returns

InMemoryMessageTransport

Properties

Property	Modifier	Type	Default value	Defined in
<a id="property-deliveries"></a> deliveries	readonly	object[]	[]	testkit/src/index.ts:38

Methods

deliver()

deliver(context, envelope): Promise<{ messageId: string; metadata?: JsonObject; status: "accepted"; timestamp: string; } | { messageId: string; metadata?: JsonObject; status: "delivered"; timestamp: string; } | { error: { code: string; details?: JsonObject; message: string; retryable?: boolean; }; messageId: string; metadata?: JsonObject; status: "denied"; timestamp: string; } | { error: { code: string; details?: JsonObject; message: string; retryable?: boolean; }; messageId: string; metadata?: JsonObject; status: "failed"; timestamp: string; }>

Defined in: testkit/src/index.ts:40

Parameters

Parameter	Type
context	{ actor: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; authority: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; enabledToolNamespaces: string[]; namespaceId: string; now: string; owner: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; purpose: string; traceId: string; }
context.actor	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }
context.authority	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }
context.enabledToolNamespaces	string[]
context.namespaceId	string
context.now	string
context.owner	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }
context.purpose	string
context.traceId	string
envelope	{ createdAt: string; id: string; payload: JsonValue; provenance?: { metadata?: JsonObject; parentIds: string[]; source: string; }; purpose: string; receiver: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; replyTo?: string; sender: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; traceId: string; version: "1"; }
envelope.createdAt	string
envelope.id	string
envelope.payload	JsonValue
envelope.provenance?	{ metadata?: JsonObject; parentIds: string[]; source: string; }
envelope.provenance.metadata?	JsonObject
envelope.provenance.parentIds	string[]
envelope.provenance.source	string
envelope.purpose	string
envelope.receiver	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }
envelope.replyTo?	string
envelope.sender	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }
envelope.traceId	string
envelope.version	"1"

Returns

Promise<{ messageId: string; metadata?: JsonObject; status: "accepted"; timestamp: string; } | { messageId: string; metadata?: JsonObject; status: "delivered"; timestamp: string; } | { error: { code: string; details?: JsonObject; message: string; retryable?: boolean; }; messageId: string; metadata?: JsonObject; status: "denied"; timestamp: string; } | { error: { code: string; details?: JsonObject; message: string; retryable?: boolean; }; messageId: string; metadata?: JsonObject; status: "failed"; timestamp: string; }>

Implementation of

MessageTransport.deliver

---

InMemoryResourceProvider

Defined in: testkit/src/index.ts:183

A host-neutral recording provider for examples, conformance tests, and isolated experiment worlds.

Implements

• ResourceProvider

Constructors

Constructor

new InMemoryResourceProvider(namespace, handler?): InMemoryResourceProvider

Defined in: testkit/src/index.ts:188

Parameters

Parameter	Type	Default value
namespace	string	undefined
handler	ResourceHandler	echoResourceOperation

Returns

InMemoryResourceProvider

Properties

Property	Modifier	Type	Default value	Defined in
<a id="property-namespace"></a> namespace	readonly	string	undefined	testkit/src/index.ts:184
<a id="property-operations"></a> operations	readonly	object[]	[]	testkit/src/index.ts:185

Methods

invoke()

invoke(operation): Promise<{ completedAt: string; metadata?: JsonObject; operationId: string; output: JsonValue; status: "succeeded"; } | { completedAt: string; error: { code: string; details?: JsonObject; message: string; retryable?: boolean; }; metadata?: JsonObject; operationId: string; status: "denied"; } | { completedAt: string; error: { code: string; details?: JsonObject; message: string; retryable?: boolean; }; metadata?: JsonObject; operationId: string; status: "failed"; }>

Defined in: testkit/src/index.ts:193

Parameters

Parameter	Type
operation	{ action: string; context: { actor: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; authority: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; enabledToolNamespaces: string[]; namespaceId: string; now: string; owner: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; purpose: string; traceId: string; }; input?: JsonValue; metadata?: JsonObject; operationId: string; resource: { namespace: string; owner?: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; path: string[]; }; }
operation.action	string
operation.context	{ actor: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; authority: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; enabledToolNamespaces: string[]; namespaceId: string; now: string; owner: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; purpose: string; traceId: string; }
operation.context.actor	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }
operation.context.authority	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }
operation.context.enabledToolNamespaces	string[]
operation.context.namespaceId	string
operation.context.now	string
operation.context.owner	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }
operation.context.purpose	string
operation.context.traceId	string
operation.input?	JsonValue
operation.metadata?	JsonObject
operation.operationId	string
operation.resource	{ namespace: string; owner?: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; path: string[]; }
operation.resource.namespace	string
operation.resource.owner?	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }
operation.resource.path	string[]

Returns

Promise<{ completedAt: string; metadata?: JsonObject; operationId: string; output: JsonValue; status: "succeeded"; } | { completedAt: string; error: { code: string; details?: JsonObject; message: string; retryable?: boolean; }; metadata?: JsonObject; operationId: string; status: "denied"; } | { completedAt: string; error: { code: string; details?: JsonObject; message: string; retryable?: boolean; }; metadata?: JsonObject; operationId: string; status: "failed"; }>

Implementation of

ResourceProvider.invoke

---

InMemoryToolNamespaceSettingsStore

Defined in: testkit/src/index.ts:54

Namespace settings fixture keyed by the access-context namespace/world.

Implements

• ToolNamespaceSettingsStore

Constructors

Constructor

new InMemoryToolNamespaceSettingsStore(initial?): InMemoryToolNamespaceSettingsStore

Defined in: testkit/src/index.ts:57

Parameters

Parameter	Type
initial	Readonly<Record<string, readonly ToolNamespace[]>>

Returns

InMemoryToolNamespaceSettingsStore

Methods

applyUpdate()

applyUpdate(context, update): Promise<readonly string[]>

Defined in: testkit/src/index.ts:63

Parameters

Parameter	Type
context	{ actor: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; authority: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; enabledToolNamespaces: string[]; namespaceId: string; now: string; owner: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; purpose: string; traceId: string; }
context.actor	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }
context.authority	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }
context.enabledToolNamespaces	string[]
context.namespaceId	string
context.now	string
context.owner	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }
context.purpose	string
context.traceId	string
update	{ disable?: string[]; enable?: string[]; }
update.disable?	string[]
update.enable?	string[]

Returns

Promise<readonly string[]>

Implementation of

ToolNamespaceSettingsStore.applyUpdate

get()

get(namespaceId): readonly string[]

Defined in: testkit/src/index.ts:75

Parameters

Parameter	Type
namespaceId	string

Returns

readonly string[]

---

UnavailableDelegationChainResolver

Defined in: testkit/src/index.ts:173

A resolver whose authoritative source is down; every lookup must fail closed.

Implements

• DelegationChainResolver

Constructors

Constructor

new UnavailableDelegationChainResolver(): UnavailableDelegationChainResolver

Returns

UnavailableDelegationChainResolver

Methods

resolve()

resolve(): Promise<{ capabilities: object[]; constraints: { delegationDepth?: number; expiresAt?: string; maxUses?: number; notBefore?: string; purposes?: string[]; }; id: string; issuedAt: string; issuer: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; metadata?: JsonObject; namespaceId: string; parentGrantId?: string; revokedAt?: string; subject: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; } | undefined>>

Defined in: testkit/src/index.ts:174

Returns

Promise<{ capabilities: object[]; constraints: { delegationDepth?: number; expiresAt?: string; maxUses?: number; notBefore?: string; purposes?: string[]; }; id: string; issuedAt: string; issuer: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; metadata?: JsonObject; namespaceId: string; parentGrantId?: string; revokedAt?: string; subject: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }; } | undefined>

Implementation of

DelegationChainResolver.resolve

---

UnavailableGrantSource

Defined in: testkit/src/index.ts:128

A grant store that is down; every decision made against it must fail closed.

Implements

• GrantSource

Constructors

Constructor

new UnavailableGrantSource(): UnavailableGrantSource

Returns

UnavailableGrantSource

Methods

load()

load(): Promise<readonly object[]>

Defined in: testkit/src/index.ts:129

Returns

Promise<readonly object[]>

Implementation of

GrantSource.load

Interfaces

TestContextOptions

Defined in: testkit/src/index.ts:238

Properties

Property	Modifier	Type	Defined in
<a id="property-actor"></a> actor?	readonly	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }	testkit/src/index.ts:239
<a id="property-authority"></a> authority?	readonly	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }	testkit/src/index.ts:240
<a id="property-enabledtoolnamespaces"></a> enabledToolNamespaces?	readonly	readonly string[]	testkit/src/index.ts:243
<a id="property-namespaceid"></a> namespaceId?	readonly	string	testkit/src/index.ts:242
<a id="property-now"></a> now?	readonly	string	testkit/src/index.ts:246
<a id="property-owner"></a> owner?	readonly	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }	testkit/src/index.ts:241
<a id="property-purpose"></a> purpose?	readonly	string	testkit/src/index.ts:244
<a id="property-traceid"></a> traceId?	readonly	string	testkit/src/index.ts:245

---

TestGrantOptions

Defined in: testkit/src/index.ts:263

Properties

Property	Modifier	Type	Defined in
<a id="property-capabilities"></a> capabilities	readonly	readonly object[]	testkit/src/index.ts:268
<a id="property-delegationdepth"></a> delegationDepth?	readonly	number	testkit/src/index.ts:275
<a id="property-expiresat"></a> expiresAt?	readonly	string	testkit/src/index.ts:272
<a id="property-id"></a> id?	readonly	string	testkit/src/index.ts:264
<a id="property-issuedat"></a> issuedAt?	readonly	string	testkit/src/index.ts:270
<a id="property-issuer"></a> issuer?	readonly	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }	testkit/src/index.ts:267
<a id="property-maxuses"></a> maxUses?	readonly	number	testkit/src/index.ts:274
<a id="property-namespaceid-1"></a> namespaceId?	readonly	string	testkit/src/index.ts:265
<a id="property-notbefore"></a> notBefore?	readonly	string	testkit/src/index.ts:271
<a id="property-parentgrantid"></a> parentGrantId?	readonly	string	testkit/src/index.ts:276
<a id="property-purposes"></a> purposes?	readonly	readonly string[]	testkit/src/index.ts:269
<a id="property-revokedat"></a> revokedAt?	readonly	string	testkit/src/index.ts:273
<a id="property-subject"></a> subject?	readonly	{ kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }	testkit/src/index.ts:266

---

TestKernel

Defined in: testkit/src/index.ts:199

Properties

Property	Modifier	Type	Description	Defined in
<a id="property-audit"></a> audit	readonly	InMemoryAuditSink	-	testkit/src/index.ts:201
<a id="property-grants"></a> grants	readonly	InMemoryGrantSource	The trusted store the kernel loads authority from; mutate it to grant or revoke.	testkit/src/index.ts:204
<a id="property-kernel"></a> kernel	readonly	SharedOSKernel	-	testkit/src/index.ts:200
<a id="property-messages"></a> messages	readonly	InMemoryMessageTransport	-	testkit/src/index.ts:202

---

TestKernelOptions

Defined in: testkit/src/index.ts:207

Properties

Property	Modifier	Type	Description	Defined in
<a id="property-delegationresolver"></a> delegationResolver?	readonly	DelegationChainResolver	Installs ancestor validation so delegated grants can be exercised.	testkit/src/index.ts:213
<a id="property-grants-1"></a> grants?	readonly	readonly object[]	Seed authority for the kernel's trusted grant source.	testkit/src/index.ts:209
<a id="property-grantsource"></a> grantSource?	readonly	GrantSource	Replaces the trusted grant source, for example to exercise an outage.	testkit/src/index.ts:211

Type Aliases

ResourceHandler

ResourceHandler = (operation) => Promise<ResourceResult>>

Defined in: testkit/src/index.ts:180

Parameters

Parameter	Type
operation	ResourceOperation

Returns

Promise<ResourceResult>

Functions

createTestContext()

createTestContext(options?): object

Defined in: testkit/src/index.ts:249

Parameters

Parameter	Type
options	TestContextOptions

Returns

object

actor

actor: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }

authority

authority: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }

enabledToolNamespaces

enabledToolNamespaces: string[]

namespaceId

namespaceId: string

now

now: string

owner

owner: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }

purpose

purpose: string

traceId

traceId: string

---

createTestGrant()

createTestGrant(options): object

Defined in: testkit/src/index.ts:279

Parameters

Parameter	Type
options	TestGrantOptions

Returns

object

capabilities

capabilities: object[]

constraints

constraints: object

constraints.delegationDepth?

optional delegationDepth?: number

constraints.expiresAt?

optional expiresAt?: string

constraints.maxUses?

optional maxUses?: number

constraints.notBefore?

optional notBefore?: string

constraints.purposes?

optional purposes?: string[]

id

id: string

issuedAt

issuedAt: string

issuer

issuer: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }

metadata?

optional metadata?: JsonObject

namespaceId

namespaceId: string

parentGrantId?

optional parentGrantId?: string

revokedAt?

optional revokedAt?: string

subject

subject: { kind: "human"; userId: string; } | { agentId: string; kind: "agent"; } | { conversationId: string; kind: "group"; } | { kind: "service"; serviceId: string; }

---

createTestKernel()

createTestKernel(options?): TestKernel

Defined in: testkit/src/index.ts:216

Parameters

Parameter	Type
options	TestKernelOptions

Returns

TestKernel