DIRECTORY 
Atom USING [ DottedPairNode, GetPName ],
Commander USING [ CommandProc, Register ],
Convert USING [ IntFromRope ],
GList USING [ DRemove ],
IO,
LarkPlay USING [ MergeToneSpecs, PlayString, ToneSpec, ToneSpecRec ],
LarkSmartsMonitorImpl,
MBQueue USING [ QueueClientAction ],
NameDB USING [ GetAttribute, SetAttribute ],
Nice,
Process USING [ Detach, SecondsToTicks, SetTimeout ],
RefID USING [ ID, Reseal, Unseal ],
RefTab USING [ Create, Fetch, Ref, Store ],
Rope USING [ Concat, Fetch, Length, ROPE ],
ThNet USING [ pd ],
ThParty USING [ Advance, ConversationInfo, DescribeParty, GetConversationInfo, GetKeyTable, GetPartyInfo, PartyInfo  ],
ThPartyPrivate USING [ GetCurrentParty ],
Thrush USING [
ActionReport, ConvEvent, ConversationID, PartyID, PartyType, NB, notReallyInConv, nullConvID, nullID, Reason, ROPE, SHHH, SmartsID, StateID, StateInConv ],
ThSmartsPrivate USING [
ConvDesc, ConvDescBody, ConvRequest, ConvRequestBody, EnterLarkState, Fail, LarkInfo, LarkState, OpenConversations, ParseState, SmartsInfo ],
ThSmartsRpcControl,
Triples USING [ Select ],
TU,
VoiceUtils USING [ MakeAtom, ProblemFR, ReportFR ]
;

LarkSmartsSupImpl: CEDAR MONITOR LOCKS root
IMPORTS
Atom,
Commander,
Convert,
GList,
IO, 
LarkPlay,
root: LarkSmartsMonitorImpl,
MBQueue,
NameDB,
Nice,
Process,
RefID,
RefTab,
Rope,
ThNet,
ThParty,
ThPartyPrivate,
ThSmartsPrivate,
Triples,
TU,
VoiceUtils

EXPORTS ThSmartsPrivate
SHARES LarkSmartsMonitorImpl = {
OPEN IO;


ConversationID: TYPE = Thrush.ConversationID;
nullConvID: ConversationID=Thrush.nullConvID;
ConvDesc: TYPE = ThSmartsPrivate.ConvDesc;
ConvEvent: TYPE = Thrush.ConvEvent;
Reseal: PROC[r: REF] RETURNS[RefID.ID] = INLINE {RETURN[RefID.Reseal[r]]; };
NB: TYPE = Thrush.NB;
OpenConversations: TYPE = ThSmartsPrivate.OpenConversations;
PartyID: TYPE = Thrush.PartyID;
nullID: RefID.ID = Thrush.nullID;
ROPE: TYPE = Thrush.ROPE;
SmartsID: TYPE = Thrush.SmartsID;
SmartsInfo: TYPE = ThSmartsPrivate.SmartsInfo;
StateInConv: TYPE = Thrush.StateInConv;
LORA: TYPE = LIST OF REF ANY;

PD: TYPE = RECORD [
timeoutNoAction: INTEGER _ 5,
doReports: BOOL_FALSE,
doNice: BOOL_FALSE
];
pd: REF PD _ NEW[PD_[]];

LarkProgress: PUBLIC ENTRY PROC[
interface: ThSmartsRpcControl.InterfaceRecord,
shh: Thrush.SHHH,
convEvent: Thrush.ConvEvent
] = {
ENABLE UNWIND => NULL; -- 
RestoreInvariant;
convID: ConversationID = convEvent.self.convID;
info: SmartsInfo = GetSmartsInfo[smartsID: convEvent.self.smartsID];
cDesc: ConvDesc;
reason: Thrush.Reason;
cInfo: REF ThParty.ConversationInfo;
whatNeedsDoing: WhatNeedsDoing;
IF info=NIL THEN { Problem["No Smarts at LarkProgress for SmartsID %g", NIL, card[convEvent.self.smartsID]]; RETURN; };
cDesc _ GetConv[ info, convID, TRUE ];

IF convEvent.self.partyID = convEvent.other.partyID THEN { -- own state changed
NoteNewState[cDesc, convEvent]; -- Report on existing conv. or notification of new one.
RETURN;
};
IF convID#info.currentConvID AND info.currentConvID#nullConvID THEN {
ForgetConv[cDesc];
RETURN;
};

whatNeedsDoing _ whatNeedsDoingIf[cDesc.situation.self.state][convEvent.other.state];
SELECT whatNeedsDoing FROM
$noop, $ntiy => NULL; -- No action is needed, or we don't know what one to take.
$imp => ERROR; -- This is supposed to be impossible!
$xrep => Problem["Didn't expect state change report", info];
$frgt => ForgetConv[cDesc];
$invl => {
Problem["Invalid state transition", info];
[]_ChangeState[cDesc: cDesc, state: $failed,
reason: $error, comment: "System Error: Invalid state transition"];
};
$idle => {
IF (cInfo _ GetConversationInfo[cDesc]) = NIL
THEN RETURN; -- have already complained
reason _ IF convEvent.reason#NIL THEN convEvent.reason ELSE $terminating;
IF (cInfo.numParties-cInfo.numIdle) <= 1 THEN
[]_ChangeState[cDesc, IF reason=$terminating THEN $idle ELSE $failed, reason]
ELSE IF cDesc.situation.self.state=$active THEN ResetLarkState[cDesc];
};
$idlerg => {
IF (cInfo _ GetConversationInfo[cDesc]) = NIL
THEN RETURN; -- have already complained
reason _ IF convEvent.reason # NIL THEN convEvent.reason ELSE $terminating;
IF cInfo.originator = convEvent.other.partyID THEN
[]_ChangeState[cDesc, IF reason=$terminating THEN $idle ELSE $failed, reason];
};
$rback => []_ChangeState[cDesc, $ringback]; -- Provide ring-back signal
$actv => []_ChangeState[cDesc, $active]; -- Go active
$ckrg => CheckRing[cDesc]; -- We're ringing; Some other party that was ringing has now become active; determine if we should continue ringing.
$reac, -- Someone else has entered or returned to active state, while we are active
$deac -- Someone else has entered inactive state.
=> ResetLarkState[cDesc];
ENDCASE => ERROR;
};

LarkSubstitution: PUBLIC ENTRY PROC[
interface: ThSmartsRpcControl.InterfaceRecord,
shh: Thrush.SHHH,
convEvent: Thrush.ConvEvent,
oldPartyID: Thrush.PartyID,
newPartyID: Thrush.PartyID
] = {
ENABLE UNWIND => NULL; -- 
RestoreInvariant;
info: SmartsInfo = GetSmartsInfo[smartsID: convEvent.self.smartsID];
cDesc: ConvDesc;
IF info=NIL THEN { Problem["No Smarts at LarkSubstitution for SmartsID %g", NIL, card[convEvent.self.smartsID]]; RETURN; };
IF (cDesc _ GetConv[ info, convEvent.self.convID, FALSE ]) = NIL THEN RETURN;
NoteNewState[cDesc, convEvent];
};

LarkReportAction: PUBLIC ENTRY PROC[
interface: ThSmartsRpcControl.InterfaceRecord,
shh: Thrush.SHHH,
report: Thrush.ActionReport
] = {
ENABLE UNWIND => NULL;
nb: NB;
info: SmartsInfo = GetSmartsInfo[smartsID: report.self.smartsID];
cDesc: ConvDesc;
IF info=NIL THEN { Problem["No Smarts at LarkSubstitution for SmartsID %g", NIL, card[report.self.smartsID]]; RETURN; };
IF (cDesc _ GetConv[ info, report.self.convID, FALSE ]) = NIL THEN RETURN;
SELECT report.actionClass FROM
$keyDistribution => {
SELECT report.actionType FROM $newKeys => NULL; ENDCASE => RETURN;
[nb, cDesc.keyTable] _ ThParty.GetKeyTable[credentials: report.self];
IF nb#$success THEN { cDesc.keyTable _ NIL; RETURN; };
IF cDesc.situation.self.state <= Thrush.notReallyInConv	THEN RETURN;
SetLarkState[cDesc, LIST[cDesc.keyTable]];
};
$recording, $playback, $synthesizer =>
SELECT report.actionType FROM
$scheduled => cDesc.lastActionID _ report.actionID;
$started => NULL; -- always follows $scheduled
$finished, $flushed => {
IF cDesc.lastActionID = report.actionID AND
cDesc.situation.self.state > Thrush.notReallyInConv AND
(SELECT cDesc.info.larkInfo.switchState FROM
speaker, monitor =>TRUE, ENDCASE =>FALSE)
THEN [] _ ChangeState[cDesc, $idle]
};
ENDCASE;
ENDCASE;
};


QdNotification: ENTRY PROC [r: REF] ~ {
ENABLE UNWIND => NULL; --  
RestoreInvariant;
cDesc: ConvDesc = NARROW[r];
{
OPEN now: cDesc.situation.self;
rNAtom: ATOM;
rName: ROPE;
val: ROPE;
IF cDesc.info.failed THEN { Problem["Notification abandoned", cDesc.info];  RETURN; };
IF now.state # $notified THEN RETURN; -- 
Nothing to do any more??
[rName, rNAtom, val] _ DBInfo[now.partyID, $deferanswer];
IF VoiceUtils.MakeAtom[val]=$true THEN TRUSTED {
Process.Detach[FORK DeferAnswer[cDesc, rName]]; RETURN; };
IF cDesc.info.currentConvID#cDesc.situation.self.convID THEN GOTO Reject;
IF ChangeState[cDesc,
IF VoiceUtils.MakeAtom[DBInfo[now.partyID, $autoanswer, rNAtom].value] = $true THEN $active
ELSE $ringing] = $success
AND now.state=$ringing THEN CheckRing[cDesc];
EXITS Reject =>
[]_ChangeState[cDesc, $idle, $busy]; -- Couldn't accept call, for whatever reason.
};
};

DeferAnswer: ENTRY PROC [cDesc: ConvDesc, rName: ROPE] ~ TRUSTED {
c: CONDITION;
Process.SetTimeout[@c, Process.SecondsToTicks[pd.timeoutNoAction]];
WAIT c;
IF cDesc.situation.self.state # $notified THEN RETURN;
NameDB.SetAttribute[rName, $deferanswer, NIL];
cDesc.info.requests.QueueClientAction[QdNotification, cDesc];
};


DoAdvance: INTERNAL PROC[convRequest: ThSmartsPrivate.ConvRequest, secondTry: BOOL_FALSE]
RETURNS [nb: NB] = {
cDesc: ConvDesc = convRequest.cDesc;
DO -- for possible stateMismatch loop
OPEN now: cDesc.situation.self, desired: convRequest.desiredSituation.self;
convEvent: Thrush.ConvEvent;
IF now.state=$idle OR now.state = desired.state THEN RETURN[$success];
[nb, convEvent] _ ThParty.Advance[
credentials: now,
state: desired.state,
reason: convRequest.desiredSituation.reason,
comment: convRequest.desiredSituation.comment,
reportToAll: shouldReportToAll[desired.state],
bilateral: convRequest.bilateral
];
SELECT nb FROM
$success => cDesc.info.NoteNewStateP[cDesc, convEvent];
$stateMismatch => {
IF secondTry THEN ERROR; -- Don't loop forever
cDesc.info.NoteNewStateP[cDesc, convEvent];
secondTry _ TRUE;
IF now.state # $idle THEN LOOP; -- Attempt the transition, based on new information.
};
$partyAlreadyActive, $conferenceConv,
$bilateralConv, $voiceTerminalUnavailable,
$interfaceError => {
IF secondTry THEN ERROR; -- Don't loop forever
IF nb=$interfaceError THEN Problem["Party state-advance yields interface error", cDesc.info];
cDesc.info.NoteNewStateP[cDesc, convEvent];
desired.state _ $idle;
IF now.state # $idle THEN [] _ DoAdvance[convRequest, TRUE];
};
ENDCASE => { -- $convIdle, $noSuchSmarts, $noSuchParty, $noSuchConv, $notInConv
msg: Rope.ROPE =
IO.PutFR["Unexpected party state-advance failure, nb=%g", atom[nb]];
IF cDesc#NIL AND cDesc.info#NIL AND cDesc.info.larkInfo#NIL THEN
ThSmartsPrivate.Fail[cDesc.info.larkInfo, msg, TRUE]
ELSE { Problem[msg, cDesc.info]; ForgetConv[cDesc]; };
};
EXIT; ENDLOOP;
};

NoteNewState: PUBLIC INTERNAL PROC[cDesc: ConvDesc, convEvent: ConvEvent] ~ {
OPEN now: cDesc.situation.self;
nb: NB;
larkStateData: LORA _NIL;
state: StateInConv _ convEvent.self.state;
previousState: StateInConv = cDesc.situation.self.state;
savedCurrentConvID: ConversationID;
cDesc.situation _ convEvent^;
IF state = previousState THEN RETURN; -- No conceivable value in acting.
IF cDesc.info.currentConvID=nullConvID THEN
cDesc.info.currentConvID _ cDesc.situation.self.convID;
savedCurrentConvID _ cDesc.info.currentConvID; -- ForgetConv might clear it.
SELECT state FROM
$notified => { -- Somebody else did the notifying.  We have to respond.
cDesc.info.requests.QueueClientAction[QdNotification, cDesc];
};
$ringing, $ringback => larkStateData _ LIST[SetupRingTunes[cDesc]];
$idle, $neverWas => ForgetConv[cDesc];
$active => {
value: ROPE; rNAtom: ATOM;
larkStateData _ LIST[ComputeConnection[cDesc]];
[, rNAtom, value] _ DBInfo[now.partyID, $audiosource];
larkStateData _ CONS[NEW[Atom.DottedPairNode_[$audioSource, VoiceUtils.MakeAtom[value]]], larkStateData]; --[[$audioSource,audioSource],...]
value _ DBInfo[now.partyID, $transmitonly, rNAtom].value;
larkStateData _ CONS[NEW[Atom.DottedPairNode_[$transmitOnly, VoiceUtils.MakeAtom[value]]], larkStateData];
};
ENDCASE;
IF state > Thrush.notReallyInConv AND cDesc.keyTable=NIL THEN {
[nb, cDesc.keyTable] _ ThParty.GetKeyTable[credentials: now];
IF nb # $success THEN cDesc.keyTable_NIL;
};
IF state> Thrush.notReallyInConv AND cDesc.keyTable#cDesc.info.larkInfo.keyTable AND cDesc.keyTable#NIL THEN larkStateData _ CONS[cDesc.keyTable, larkStateData];
IF now.convID = savedCurrentConvID THEN SetLarkState[cDesc, larkStateData];
};

CheckRing: PUBLIC INTERNAL PROC [cDesc: ConvDesc] ~ {
nb: NB;
cInfo: ThParty.ConversationInfo;
[nb, cInfo] _ ThParty.GetConversationInfo[convID: cDesc.situation.self.convID];
IF nb # $success THEN {
[]_ChangeState[cDesc, $failed, $error, "System Error: can't monitor ringing situation"];
RETURN;
};
IF cDesc.ringCheckProcess#NIL OR -- Already handling
cInfo.numActive = 0 THEN RETURN; -- Not in the interesting situation yet.
TRUSTED { Process.Detach[FORK RingProcess[cDesc]]; };
};

RingProcess: ENTRY PROC[cDesc: ConvDesc] = {
ENABLE UNWIND => { cDesc.ringCheckProcess _ NIL; };
numWaited: INT_0;
numToWait: INT_0;
condition: CONDITION;
TRUSTED { Process.SetTimeout[@condition, Process.SecondsToTicks[1]]; };
WHILE TRUE DO
value: ROPE_NIL;
valueAtom: ATOM;
IF cDesc.info.failed OR cDesc.situation.self.state # $ringing THEN EXIT;
value _ DBInfo[cDesc.situation.self.partyID, $multiring].value;
valueAtom _ VoiceUtils.MakeAtom[value];
SELECT TRUE FROM
valueAtom=NIL, value.Length[]=0, valueAtom=$false => numToWait_numWaited; -- quit
valueAtom=$true => { numToWait_numWaited+1; }; -- forever
value.Fetch[0] IN ['0..'9] => numToWait_Convert.IntFromRope[value];
ENDCASE => numToWait _ numWaited; -- invalid database
IF numWaited >= numToWait THEN GOTO Idle;
WAIT condition;
numWaited _ numWaited+1;
REPEAT
Idle => []_ChangeState[cDesc, $idle]; -- We're a third wheel.
ENDLOOP;
cDesc.ringCheckProcess _ NIL;
};


ChangeState: PUBLIC INTERNAL PROC[
cDesc: ConvDesc,
state: StateInConv _ $idle,
reason: Thrush.Reason _ NIL, -- $wontSay
comment: ROPE_NIL,
bilateral: BOOL_FALSE
] RETURNS [nb: NB _ $noSuchConv] = {
convRequest: ThSmartsPrivate.ConvRequest;
IF cDesc = NIL THEN { Problem["No cDesc supplied at ChangeState", NIL]; RETURN; };
IF state=$failed AND cDesc.info.larkInfo.textToSpeech THEN state _ $idle;
convRequest _ NEW[ThSmartsPrivate.ConvRequestBody _ [cDesc: cDesc, bilateral: bilateral]];
convRequest.desiredSituation.self.state _ state;
convRequest.desiredSituation.reason _ reason;
convRequest.desiredSituation.comment _ comment;
nb _ DoAdvance[convRequest];
};

GetConv: PUBLIC INTERNAL PROC[info: SmartsInfo, convID: ConversationID, createOK: BOOL_FALSE
] RETURNS [ cDesc: ConvDesc_NIL ] = --INLINE-- {
nb: NB;
partyID: PartyID;
FOR convs: OpenConversations _ info.conversations, convs.rest WHILE convs#NIL DO
IF convs.first.situation.self.convID = convID THEN RETURN[convs.first];
ENDLOOP;
IF ~createOK THEN {
VoiceUtils.ProblemFR["Couldn't find referenced conversation, id= %g",
$System, NIL, time[convID]];
RETURN;
};
[nb, partyID] _ ThPartyPrivate.GetCurrentParty[smartsID: info.smartsID];
SELECT nb FROM
$success => NULL;
$noSuchSmarts, $noSuchParty => {
VoiceUtils.ProblemFR["Party has apparently failed; damage control.", $System, NIL];
RETURN;
};
ENDCASE => ERROR;
cDesc _ NEW[ThSmartsPrivate.ConvDescBody_[]];
cDesc.situation.self _ [ convID: convID, smartsID: info.smartsID, partyID: partyID ];
cDesc.info _ info;
info.conversations _ CONS[cDesc, info.conversations];
IF pd.doReports THEN
ReportFR["  ** NewConv %t %g\n", info, time[convID], TU.RefAddr[info] ];
};

ForgetConv: PUBLIC INTERNAL PROC[cDesc: ConvDesc] = {
info: SmartsInfo = cDesc.info;
IF cDesc.situation.self.convID = info.currentConvID THEN info.currentConvID _ nullConvID;
info.conversations _ NARROW[GList.DRemove[cDesc, info.conversations]];
};

ComputeConnection: PUBLIC INTERNAL PROC[cDesc: ConvDesc]
RETURNS [pInfo: ThParty.PartyInfo _ NIL] = {
nb: NB;
[nb, pInfo] _
ThParty.GetPartyInfo[credentials: cDesc.situation.self, nameReq: $none, allParties: TRUE];
IF nb # $success OR pInfo[0].partyID=0 THEN {
Problem["No conversation info, or incomplete", cDesc.info]; pInfo_NIL; RETURN; }; -- This is really bad!
};

GetSmartsInfo: PUBLIC PROC[smartsID: SmartsID] RETURNS [info: SmartsInfo_NIL] = {
sd: REF _ RefID.Unseal[smartsID];
IF sd#NIL THEN RETURN[NARROW[Triples.Select[$SmartsData, sd, --info--]]];
};

DBInfo: PUBLIC PROC[partyID: Thrush.PartyID, attribute: ATOM_NIL, prevRNAtom: ATOM_NIL]
RETURNS [rName: ROPE_NIL, rNAtom: ATOM_NIL, value: ROPE_NIL] = {
nb: NB _ $success;
rNAtom _ prevRNAtom;
IF rNAtom#NIL THEN rName _ Atom.GetPName[rNAtom]
ELSE IF partyID#nullID THEN
[nb, rName] _ ThParty.DescribeParty[partyID: partyID, nameReq: $current];
IF nb # $success OR rName=NIL THEN RETURN;
IF rNAtom=NIL THEN rNAtom _ VoiceUtils.MakeAtom[rName: rName, case: FALSE];
IF attribute#NIL THEN value _ NameDB.GetAttribute[rName, attribute];
};

GetConversationInfo: INTERNAL PROC[cDesc: ConvDesc]
RETURNS [cInfo: REF ThParty.ConversationInfo] = {
nb: NB;
cInfoRecord: ThParty.ConversationInfo;
[nb, cInfoRecord] _ ThParty.GetConversationInfo[convID: cDesc.situation.self.convID];
SELECT nb FROM
$success => NULL;
$noSuchConv => {
Problem["Conversation disappeared, can't get ConversationInfo", cDesc.info];
ForgetConv[cDesc];
RETURN[NIL];
};
ENDCASE => ERROR;
RETURN[NEW[ThParty.ConversationInfo _ cInfoRecord]];
};

Problem:
PROC[comment: ROPE, info: SmartsInfo, v1: IO.Value _ [null[]]] = {
VoiceUtils.ProblemFR[Rope.Concat["LarkSmarts(%g): ", comment], $Smarts, info, TU.RefAddr[info], v1];
};

ReportFR: PROC[what: ROPE, info: SmartsInfo, a1, a2, a3: IO.Value_rope[NIL]] = {
IF NOT pd.doReports THEN RETURN;
VoiceUtils.ReportFR[what, $Lark, info.larkInfo, a1, a2, a3];
};

BeNice: PROC[r: REF, d: INT, info: SmartsInfo] = {
IF NOT pd.doNice THEN RETURN;
Nice.BeNice[r, d, $Lark, info.larkInfo];
};

ringTunes: RefTab.Ref_RefTab.Create[59];
ringTone: LarkPlay.ToneSpec _ NIL;
subduedRingTone: LarkPlay.ToneSpec _ NIL;
outsideRingTone: LarkPlay.ToneSpec _ NIL;
outsideRingTune: PUBLIC LarkPlay.ToneSpec _ NIL;
outsideRingTuneRope: ROPE _ "@300;G%>G<%G%>G<%G%>G<%G%>G<%G%>*C";
ringTuneDelay: NAT _ 2400; -- ms. delay between tune starts.

SetupRingTunes: PROC[cDesc: ConvDesc] RETURNS [toneSpec: LarkPlay.ToneSpec] = {
OPEN self: cDesc.situation.self;
partyID: Thrush.PartyID = self.partyID;
rName: ROPE;
originatingPartyID: Thrush.PartyID_nullID;
otherRName: ROPE;
otherTune: LarkPlay.ToneSpec_NIL; 
otherType: Thrush.PartyType_$service; -- default value: not telephone, individual, trunk
defaultSpec: LarkPlay.ToneSpec; -- outside or inside ringing

nb: NB;
pInfo: ThParty.PartyInfo;
divisor: NAT _ 1;
rope: ROPE;
now: BasicTime.GMT = BasicTime.Now[];
ringMode: ATOM;
ringDo: ATOM;

IF ThNet.pd.ringsInvalid THEN MakeDefaultRingTunes[];
[nb, pInfo] _
ThParty.GetPartyInfo[credentials: [convID: self.convID, partyID: partyID], allParties: TRUE, nameReq: $current];
IF nb#$success OR pInfo.numParties=0 THEN RETURN[ringTone]; -- not worth messing about
IF self.state=$ringing THEN originatingPartyID _ pInfo.conversationInfo.originator;
rName _ pInfo[0].intendedName; -- self
FOR i: NAT IN [1..pInfo.numParties) DO
SELECT self.state FROM
ringback => SELECT pInfo[i].state FROM
ringing, notified => {
toneSpec _ GetRingTune[pInfo[i].intendedName];
IF toneSpec=NIL THEN RETURN[ringTone];
toneSpec _ NEW[LarkPlay.ToneSpecRec _ toneSpec^];
toneSpec.volume _ ThNet.pd.tonesVolume+2;
toneSpec.repeatIndefinitely _ TRUE;
RETURN;
};
ENDCASE;
ringing => IF pInfo[i].partyID = originatingPartyID THEN {
otherType _ pInfo[i].type;
otherRName _ pInfo[i].intendedName;
EXIT;
};
ENDCASE=>ERROR;
ENDLOOP;

IF self.state= ringback THEN RETURN[ringTone]; -- Didn't find another party above.
defaultSpec _ SELECT otherType FROM $trunk => outsideRingTone, ENDCASE => ringTone;
rope _ NameDB.GetAttribute[rName, $ringmode];
ringMode _ IF rope=NIL THEN $r ELSE VoiceUtils.MakeAtom[rName: rope, case: FALSE];
SELECT ringMode FROM -- $o, $s, $r
$o => RETURN[NIL];
$s => RETURN[subduedRingTone];
$r => NULL; -- largest case continues below
ENDCASE => RETURN[defaultSpec]; -- unknown case; act vanilla
rope _ NameDB.GetAttribute[rName, $dotune];
ringDo _ IF rope=NIL THEN $standard ELSE VoiceUtils.MakeAtom[rName: rope, case: FALSE];
SELECT ringDo FROM
$false, $standard => RETURN[defaultSpec];
$both => {
SELECT otherType FROM
$individual, $telephone => {
divisor _ 2;
rope _ NameDB.GetAttribute[otherRName, $dotune];
ringDo _ IF rope=NIL THEN $standard ELSE VoiceUtils.MakeAtom[rName: rope, case: FALSE];
IF ringDo=$both THEN otherTune _ GetRingTune[otherRName];
};
$trunk => otherTune _ outsideRingTune;
ENDCASE;
};
$true, $tune => NULL; -- continue below
ENDCASE => RETURN[defaultSpec];
toneSpec _ GetRingTune[rName];
IF toneSpec=NIL THEN RETURN[defaultSpec];
IF otherTune#NIL THEN toneSpec _ LarkPlay.MergeToneSpecs[toneSpec, otherTune, divisor, ringTuneDelay];
};

GetRingTune: PROC[name: ROPE] RETURNS [ringTune: LarkPlay.ToneSpec_NIL] = {
nameAtom: ATOM;
ringTuneRope: ROPE;
IF name=NIL THEN RETURN;
ringTuneRope _ NameDB.GetAttribute[name, $ringtune];
IF ringTuneRope=NIL THEN RETURN;
nameAtom _ VoiceUtils.MakeAtom[name];
ringTune _ NARROW[ringTunes.Fetch[nameAtom].val];
IF ringTune#NIL AND ringTune.asRope=ringTuneRope THEN RETURN;
ringTune _ LarkPlay.PlayString[music: ringTuneRope, file: FALSE, volume: ThNet.pd.defaultRingVolume];
[]_ringTunes.Store[nameAtom, ringTune]
};

MakeDefaultRingTunes: PROC = {
ringTone _ NEW[LarkPlay.ToneSpecRec _ [
repeatIndefinitely: TRUE, volume: ThNet.pd.defaultRingVolume,
tones: LIST[LIST[ [f1: 440, f2: 480, on: 2000, off: 4000],
			     [f1: 440, f2: 480, on: 2000, off: 4000]]]]]; 
outsideRingTone _ NEW[LarkPlay.ToneSpecRec _ [
repeatIndefinitely: TRUE, volume: ThNet.pd.defaultRingVolume,
tones: LIST[LIST[ [f1: 440, f2: 480, on: 500, off: 500],
			     [f1: 440, f2: 480, on: 500, off: 4500]]]]]; 
subduedRingTone _ NEW[LarkPlay.ToneSpecRec _ [
repeatIndefinitely: FALSE,
volume: ThNet.pd.defaultRingVolume+ThNet.pd.subduedVolumeInterval,
tones: LIST[LIST[[f1: 440, f2: 480, on: 500, off: 0]]]
]]; 
outsideRingTune _
LarkPlay.PlayString[outsideRingTuneRope, FALSE, ThNet.pd.defaultRingVolume];
ThNet.pd.ringsInvalid _ FALSE;
};


larkStateForState: ARRAY StateInConv OF ThSmartsPrivate.LarkState _ [
silence,    idle,  errorTone, dialTone, silence,   silence,   silence,    ringBack, ringing,
silence,        talking,  silence
];

SetLarkState: INTERNAL PROC[cDesc: ConvDesc, data: LORA ] = {
larkState: ThSmartsPrivate.LarkState _ larkStateForState[cDesc.situation.self.state];
larkInfo: ThSmartsPrivate.LarkInfo _ cDesc.info.larkInfo;
IF larkInfo.forwardedCall THEN RETURN -- don't even heed data
ELSE IF larkState # larkInfo.larkState THEN SELECT larkState FROM
$talking => {
spec: ThParty.PartyInfo;
FOR dL: LORA  _ data, dL.rest WHILE dL#NIL DO WITH dL.first SELECT FROM
pI: ThParty.PartyInfo => spec _ pI;
ENDCASE; ENDLOOP;
IF spec=NIL THEN ERROR;
IF spec.conversationInfo.numActive < 2 OR
(spec.conversationInfo.bilateralConv AND spec[0].socket.host=spec[1].socket.host) THEN
larkState _ larkInfo.larkState; -- don't change
};
$idle => IF larkInfo.forwardedCall THEN larkState _ larkInfo.larkState;
$errorTone => larkState _ IF larkInfo.forwardedCall THEN larkInfo.larkState -- 
??
ELSE SELECT cDesc.situation.reason FROM
$busy, $notImportantEnough => $busyTone,
$absent, $noCircuits, $noParticular, $notFound, $error => $errorTone,
ENDCASE => $errorTone;
ENDCASE;
ThSmartsPrivate.EnterLarkState[cDesc.info.larkInfo, larkState, data];
};

ResetLarkState: INTERNAL PROC[cDesc: ConvDesc] = {
SetLarkState[cDesc, LIST[ComputeConnection[cDesc]]];
};


shouldReportToAll: ARRAY StateInConv OF BOOL = [
FALSE,   TRUE, FALSE,  FALSE,    FALSE,    FALSE, FALSE,    FALSE,     TRUE,    TRUE,    TRUE,     TRUE ];
   
WhatNeedsDoing: TYPE = ATOM; -- {

whatNeedsDoingIf: ARRAY StateInConv OF ARRAY StateInConv OF WhatNeedsDoing _ [
[ $imp, $frgt, $frgt, $frgt, $frgt,  $frgt, $frgt, $frgt, $frgt, $frgt,   $frgt, $frgt], --neverWas
[ $imp, $noop, $noop, $noop,  $noop,  $noop, $noop, $noop, $noop, $noop,   $noop, $ntiy ], -- idle
[ $imp, $noop, $noop, $noop,  $noop,  $noop, $noop, $noop, $noop, $noop,   $noop, $ntiy ], -- failed
[ $imp, $imp,  $imp,  $imp,   $imp,   $imp,  $imp,  $imp,  $imp,  $imp,    $imp,  $imp ], -- reserved
[ $imp, $imp,  $imp,  $imp,   $imp,   $imp,  $imp,  $imp,  $imp,  $imp,    $imp,  $imp ], -- parsing
[ $imp, $idle,$noop, $invl,  $invl,  $invl, $xrep, $xrep,$rback,$actv,  $actv, $actv ], -- initiating
[ $imp, $idlerg,$noop, $invl,  $invl,  $invl, $xrep, $noop, $noop, $ntiy,   $noop, $ntiy ], -- notified
[ $imp, $idle,$noop,$invl,   $invl,  $invl, $noop, $xrep, $noop, $ntiy,   $actv, $ntiy ], -- ringback
[ $imp, $idlerg,$noop, $invl,  $invl,  $invl, $xrep, $xrep, $noop, $ntiy,   $ckrg, $ntiy ], -- ringing
[ $imp, $idle,$noop, $invl,  $invl,  $invl, $xrep, $xrep, $noop, $ntiy,   $ckrg, $ntiy ], -- canActivate
[ $imp, $idle,$noop, $invl,  $invl,  $invl, $xrep, $xrep, $noop, $ntiy,   $reac, $deac ], -- active
[ $imp, $idle,$invl, $invl,  $invl,  $invl, $xrep, $xrep, $noop, $ntiy,   $ntiy, $ntiy ] -- inactive (current ^)
];

ViewCmd: Commander.CommandProc = TRUSTED {
Nice.View[pd, "Lark PD"];
};
Commander.Register["VuLarkSmarts", ViewCmd, "Program Management variables for Lark Smarts"];
}.
2ψLarkSmartsSupImpl.mesa
Copyright Σ 1985, 1986, 1987 by Xerox Corporation.  All rights reserved.
Last modified by D. Swinehart, April 6, 1987 8:23:23 am PDT
Polle Zellweger (PTZ) August 27, 1985 9:07:50 pm PDT

Definitions
Party-invoked actions

Some party has changed state in a conversation we know about.
Three cases:
Another smarts initiated a state change for this party, and we're not receptive.
(For now, when we don't know about that conversation and are already in another)
Another smarts initiated a change for this party, and we're receptive.
(New conversation and we're idle or it's a conversation we're in already)
Another party changed state in a conversation we know about.
Situation is that someone else reported a change of theirs concerning a conversation we've expressed no interest in.  This occurs when we've decided not to participate in a multi-party conversation.  It will occur repeatedly until everybody has quit. This situation can arise normally, for example, when a visitor or visitee is busy when a call comes in.
Someone else's state changed in a conv. we're interested in; see if it means anything to us!
We don't expect reports of state changes like $notified and $ringback to be reported to us unless it's us.
We were told something about a conversation we didn't particularly care to know about.  Forget it.
We don't know a valid interpretation of this transition on someone else's part when we're in the state we're in.
Somebody just quit.  If everybody else has quit, quit too.
We're ringing.  Somebody just quit.  If it was the originator, quit too.
A poacher has substituted for a poachee, or the other way around.  Update state so that if it's us, we know who we are.
No conversation state has changed, so just update our notion of our state and quit.
Assume problem analyzed elsewhere 
If the handset and speaker switches are in their "off" positions, terminate the connection when all recording or synthesis activity has completed.  N.B. There's a faint possibility that the $recording service and the $synthesizer service will generate non-disjoint ID's.  This could cause the connection to terminate prematurely.
Queued procedures  via request or party->smarts report
All have prefix "Qd" (queued request)

The only ones left are those that avoid recursive calls on ThParty.Advance and on NoteNewState.  Even those could probably be eliminated with a bit more thought.  Like maybe Loop with the resulting ConvEvent.  

We have been invited to join a conversation, and we were not otherwise occupied.  Decide how to deal with it.  r is the updated cDesc
The only question is whether to ring or to accept right away.
Now test whether Manager (workstation program) has assumed the responsibility for determining the  incoming calls.
This works even if what we're planning to do is to reject due to multiple simultaneous conversations!  Manager can thus override the prohibition.
We were told not to automatically accept this call, but no one has done anything about it for some time; notified is supposed to be a transitory state.  Cancel the restraining order and let the call ring through.  Whoever issued the restraining order will have to issue another one.

This can also be the home of something that refuses to stay in the state "initiating" for too long.  To date, it's been something that dealt with the state "notified". 
Action procedures: change state, queue up interval request, and so on.
All have prefix "Do"
We and some other smarts acting on our behalf requested something at the same time.  The other one got there first.
Try the philosophy that the last one in wins.  Unless the previous transition was to the $idle state, now attempt to attain the one requested here.  (Not sure about active => ringing, but let's see)
A return of stateMismatch from this routine indicates a failure based on the party having become idle during the attempt.
The transition didn't occur.  These things can happen.  We're postulating that the proper response is always to attempt to reach an idle state, before returning the original error code.  Caller must take any additional cleanup action, but usually none is required.
We requested a state later than the current state.  This is fatal.  Try to get out cleanly.
Return the original error code.
Callers should attempt minimal activity after one of these major errors.
It would probably be acceptable to crash on these errors, since they should have been reported to us under normal Lark failure conditions.
DoAdvance.nb~$success -- questionable
Update procedures: record state changes, take local actions based on what they are, and so on.
All Update procedures have prefix "Note".  These procedures should never result directly in another ThParty request, to avoid uncontrolled recursions.  (It might be necessary for them to queue another -- thinking particularly of the "going idle" case.)

cDesc hasn't been updated with convEvent, yet, so comparisons of previous and current state are possible here if desirable.
ELSE IF cDesc.info.currentConvID#cDesc.situation.self.convID THEN ERROR;

We're going to have to learn to deal with multiple conversations.  Soon.  Right now they sail right through under some circumstances.  See Notes.
This is the only time a change in our own state has to be reacted to.  Still queued up because otherwise the state-management is confusing. Or maybe it isn't.
Earliest opportunity to get keys
The test prevents changes in lark state for a conversation that we're participating in but don't have the voice terminal connected to.
Call is in progress, but we haven't joined it yet.  Decide how long to stay around.

Connection Management Utilities
Don't send t-t-s service into failed state.  Just quit!
ChangeState.nb~$ a variety of nb-errors.
On return, all errors have been handled as well as possible, though; callers should just
do minimum additional work when errors have occurred.
Just remove its cDesc from info.conversations; also clear info.currentConvID if it's us.
Socket assignment:  Each transmitting host gets an assigned socket (ThParty makes them) and ThParty.GetPartyInfo returns a list of them (self first).  One transmits voice to a socket comprised of the other host's address combined with one's OWN socket number.  In a conference, the other host is the multicast host.  One listens to some number of sockets, comprised of the other host's (or multicast) address, and their own socket numbers.  This makes the multicast case consistent.
A ConnectionSpec, when sent to the lark, includes:
buffer: {in1, in2, out1, out2, out3}.  A buffer to which analog-to-ethernet (ini, corresponding to txi) or ethernet-to-analog (outj, corresponding to rxj) samples for this connection will be queued.  When running the standard program O3I1 (1 in, 3 out) only in1 can be used, and any ethernet-to-analog connection can be assigned to any of the outj buffers.  This is the conference mode.  When running O2I2 (2 in, 2 out), in1 and out1 are paired, as are in2 and out2; out3 is not used.  This is the "simultaneous back door and front door call" mode.
localSocket: for ini (txi) buffers, this is ignored by the Lark Pup code.  For outj (rxj) buffers, this specifies the socket on which to listen -- see above.
remoteSocket: ignored for outj (rxj) buffers.  For in1 (tx1) buffers, specifies the socket to send to.
This call now simply gets the PartyInfo from ThParty; LarkOutImpl produces the actual connection specs and sends them on to the lark.

Other Utilities
Ring Tune Stuff  but for GFI's, would move to another file.

ringback: choose original called party's ring tune for ringback tune.  Or if more than one party is being called, use the first one that's still ringing or notified.
ringing: find the originator's party, in case we're going to play a duet.

We are being called.  Figure out how to respond.  Obtain the ringing mode.

We're ringing.  Figure out how to do it.
This produces a second ring tune, compatible with the callee's; they will be played together.
Returns the ring tune, if any, associated with the party.  If the caller wants to change anything, it must copy the results, since GetRingTune doesn't.
State Transition Tables
neverWas, idle,  failed,    reserved, parsing,  initiating, pending,  maybe,   ringing, 
canActivate,  active,   inActive
If connection is to the back door on the same machine, Trunk smarts has already set state to trunkTalking, or is about to.  Don't change it.
See the discussion of sockets  they'll be equal only when sender and receiver is same host. 
We're disallowing conferences in this case.
Telset doesn't control Lark
Should we report this transition to everyone, or just to our own smartses?
never    idle  error   reserved  parsing   init   notified  ringback   ringing  canAc    active    inactive
Just codes to dispatch on in Supervisor; explained there
$noop, $idle, $idlerg, $actv, $rback, $reac, $deac, $ckrg, $frgt, -- cases explained in code
$invl, -- considered an invalid request
$xrep, -- we got a report we feel we shouldn't have got
$ntiy, -- not implemented yet
$imp --  this situation should not arise even in the face of invalid requests
};
If we're in the state identified by the row, and someone else in the conversation reports a transition onto the state identified by the column, what should we do?

 never idle   failed resrv  pars    init   notif  rback  ring  canAc     activ inact -- _ (other)
(Clip this table to view without these comments.)
This situation arises when we've forgotten about the conversation that somebody else is still reporting on.
The actions of other parties are not of interest to us yet, since they're not in this conv.
Ditto.
They can either enter ringing to indicate interest, or go active without ringing
We don't expect to hear from others while we're deciding whether to play
They have earlier expressed interest noopringing), and are now joining the fray
The only thing that interests us here is everybody else quitting.
Debugging nonsense
Swinehart, May 15, 1985 11:05:22 am PDT
Cedar 6.0, add Prose stuff as direct copy of Interval stuff.
changes to: IntervalSpecs, ProseSpec, ProseSpecs, LarkState, LarkProgress, LarkSupervise, EnqueueProses
Swinehart, May 22, 1985 12:15:11 pm PDT
hotLine => autoAnswer
changes to: LarkSupervise
Swinehart, July 2, 1985 10:09:14 am PDT
Fixing up trunkTalking stuff
changes to: LarkSupervise, LarkStateForState
Polle Zellweger (PTZ) July 11, 1985 6:15:01 pm PDT
changes to: DIRECTORY, EnqueueProses, ReportProseDone, LarkSupervise
Polle Zellweger (PTZ) July 16, 1985 9:42:51 pm PDT
changes to: LarkProgress, LarkSupervise, ReportProseDone
Polle Zellweger (PTZ) July 30, 1985 4:41:39 pm PDT
Handle copying of newProses correctly - give Lark its own copy.
changes to: LarkSupervise
Swinehart, August 6, 1985 2:26:39 pm PDT
Merge PTZ ProseSpec changes
changes to: DIRECTORY, LarkProgress, LarkSupervise, EnqueueProses
Polle Zellweger (PTZ) August 14, 1985 6:12:13 pm PDT
Prose flushing, also fix undesired speakerphone hangup for intervals, proseSpecs.
changes to: LarkProgress, LarkSupervise
Polle Zellweger (PTZ) August 22, 1985 2:04:45 pm PDT
changes to: LarkProgress -- comment out some optimizing queue flushing
Swinehart, October 28, 1985 9:58:08 am PST
Handle => ID, H => Reseal, Log => VoiceUtils
changes to: DIRECTORY, LarkSmartsSupImpl, ConversationID, Reseal, IntervalSpec, NB, nullID, PartyID, SmartsID, LarkProgress, LarkSupervise, GetConv, GetSmartsInfo
Swinehart, November 9, 1985 5:03:39 pm PST
Major revision: MBQueue replaces supervisor process.  More responsibility for own state transitions, socket calculations, key maintenance, ...
changes to: LarkProgress, NoteProgress, LarkSupervise, GetConv, larkStateForState, transForStates, ConvEvent, NoteProgress, RejectCall, NoteNewState, LarkSupervise, whatNeedsDoingIf, pairedState, WhatNeedsDoing, ]

Swinehart, June 1, 1986 7:33:23 pm PDT
Test hypothesis that Smarts supervisory actions don't have to be queued, since progress reports are queued at the Party level.  Will vastly simplify Smartses.  Keep the MBQueue around for things that might take a while and that can be done out of sequence.  In fact, can keep LarkSmartsImpl's use of the MBQueue around for a while.  It's harmless, says here.  Left in also to help with QdNotification, although that's considered eliminatable.
changes to: LarkProgress, LarkSubstitution, QdLarkProgress, QdSubstitution, QdNotification, NoteNewState, LarkReportAction


Swinehart, January 1, 1987 9:54:27 pm PST
Still working on FD/BD conflict stuff.  Pushing it back to Party level.
changes to: DIRECTORY, LarkProgress, QdNotification, NoteNewState

Swinehart, January 27, 1987 5:05:49 pm PST
Updating error management (NB-handling)
changes to: QdNotification, DoAdvance, ChangeState, GetConversationInfo, SetupRingTunes
Swinehart, April 6, 1987 8:07:48 am PDT
Cedar 7.0; accommodate NamesGV => NameDB
changes to: DIRECTORY, LarkSmartsSupImpl, PD, DeferAnswer, DBInfo, SetupRingTunes, GetRingTune
changes to: QdNotification, NoteNewState

ΚS˜š
œ™Icodeš
œH™HJš
œ;™;K™4J™—šΟk	œ
˜
Jšœœ˜(Jšœ
œ˜*Jšœœ˜Jšœœ
˜Jšœ
˜Jšœ	œ7˜EJ˜Jšœœ˜$J˜,J˜Jšœœ(˜5Jšœœœ˜#J˜+Jšœœ!˜+Jšœœ˜Jšœœj˜wJšœœ˜)Jš	œœ@œ/œœ#˜ͺ
šœœ˜Jš
œ
˜
—Jš
œ˜Jšœœ˜Jš
˜Jš
œ2˜2J˜
J˜—šœ
œ
œ˜+š
˜J˜Jš
œ
˜
J˜J˜Jšœ˜J˜	J˜J˜J˜J˜J˜J˜J˜J˜J˜J˜J˜J˜J˜Jš
˜J˜
J˜—Jšœ˜Jšœ˜ Jšœ
œ
˜J˜—™J˜šœœ˜-Jš
œ-˜-—Jšœ
œ˜*Jšœœ˜#JšΟnœœœœœœœ˜LJšœœ
œ
˜Jšœœ%˜<šœ	œ˜J˜!—Jšœœ
œ
˜Jšœ
œ˜!Jšœœ˜.Jšœ
œ˜'Jšœœœ
œ
œ
œ
˜J˜šœœœ˜Jšœœ˜Jšœœ
œ
˜Jšœœ
˜J˜—Jš	œœ
œœ
œ˜J˜—š
œ™J™šžœœ
œ
œ
˜ J˜.Jšœœ
˜Jš
œ˜Jš
œ˜Kšœ
œœΟc˜-J™=™™PJ™P—™FJ™I—J™<—Jš
œ/˜/Jš
œD˜DJ˜K˜Kšœœ˜$J˜Jš
œœ
œ8œ œ˜wJšœœ˜&J˜šœ2œŸ˜OKšœ Ÿ7˜WKšœ
˜K˜—šœœœ˜EJš
œβ™βJš
œ˜Jšœ
˜Jš
œ˜—J˜Jš
œ\™\Kš
œU˜Ušœ˜KšœœŸ:˜PKšœœŸ%˜4š
œ<˜<K™j—˜K™b—š
œ
˜
K™pKš
œ*˜*š
œ,˜,Kš
œC˜C—Kš
œ˜—š
œ
˜
Kš
œ:™:šœ(˜-Kšœ
œŸ˜'—Kš	œ	œœ
œœ˜Išœ'˜-Kšœœœœ˜M—Kšœ
œ$œ˜FK˜—˜K™Hšœ(˜-Kšœ
œŸ˜'—Kš	œ	œœ
œœ˜Kšœ,˜2Kšœœœœ˜N—K˜—Kšœ,Ÿ˜GKšœ)Ÿ˜5KšœŸs˜Ž
KšœŸL˜SšœŸ+˜1Kš
œ˜—Kšœœ
˜—J˜J˜—šžœœ
œ
œ
˜$J˜.Jšœœ
˜Jš
œ˜J˜J˜Jš
œ˜Kšœ
œœŸ˜-J™wK™SJš
œD˜DJ˜Jš
œœ
œ<œ œ˜{Jš
œ0œœ
œ
œ
˜MJ˜J˜J˜—šžœœ
˜$J˜.Jšœœ
˜Jš
œ˜Jš
œ˜Jšœ
œœ
˜Jšœœ
˜Jš
œA˜AJ˜Jš
œœ
œ<œœ˜xJš
œ-œœ
œ
œ
˜Jšœ˜š
œ˜Jš
œœ
œœœ
˜BJ˜Ešœ
œœœ˜6Jš
œ"™"—Jšœ6œ
œ
˜DJšœœ˜*J˜—š
œ&˜&Jšœ”
Οtœ°
™Ιšœ˜Jš
œ3˜3JšœœŸ˜.˜šœ&˜+Jšœ4˜7šœ
œ!˜,Jšœœœœ
˜)—Jšœ˜#—J˜—Jšœ
˜——Jšœ
˜—Jš
œ˜—˜J˜——šœŸ%™7J™%Jš 
œ‘
 2™Τ
J™šžœœ
œœ˜'K™…
Kšœ
œœŸ˜.Kšœœ˜˜
Kšœ˜Kšœœ
˜
Kšœœ
˜Kšœœ
˜
K™=Kšœœ3œ˜VKš
œœ
œŸ 
Ÿ 
˜CK™rKš
œ9˜9šœ œ
œ˜0Kšœœœ˜:K™‘
—Kšœ6œ
œ˜Išœ˜šœMœ˜[Kšœ˜——Kšœœ˜-šœ
˜Kšœ%Ÿ-˜R—K˜—K˜K˜—š
žœœ
œœœ˜BKšœ	œ
˜
K˜CKšœ˜Kšœ(œ
œ
˜6K™šKš 
Ϭ
 
™ͺ
Kšœ)œ˜.Kš
œ=˜=K˜J˜——™FJ™J˜š
ž	œœ
œ6œ
œ
˜YKšœœ˜K˜$Kšœ
Ÿ"˜%KšœG˜KK˜Kšœœœ
œ˜Fš
œ"˜"Kš
œ˜Kš
œ˜Kš
œ,˜,Kš
œ.˜.Kš
œ.˜.K˜ Kš
œ˜—šœ˜K˜7˜K™sK™Ζ
Kšœœ
œŸ˜.K˜+Kšœœ
˜Kšœœ
œŸ4˜TK™yK˜—Kš
œ%˜%š
œ*˜*Kš
œˆ™ˆ—š
œ˜K™[Kšœœ
œŸ˜.KšœœC˜]K˜+Kš
œ˜Kšœœœ˜<K™K˜—šœŸB˜Ošœ
œ˜KšœB˜D—š
œœ
œœ
œœ
˜@šœ/œ
˜4K™HK™Š
——Kšœ2˜6K˜——Kšœœ
˜K˜K™%K˜——™^J™ό
J™šžœœ
œ+˜MKšœ˜Kšœœ
˜Kšœœ
œ
˜K˜*K˜8K˜#K™{K˜Kšœœ
œŸ"˜Hšœ%˜+K˜7—šœ
œ6œ
œ
™HKš 
œH J™“
—Kšœ/Ÿ˜Lšœ˜šœŸ8˜GK™ž
Kš
œ=˜=K˜—Kšœ'œ˜CK˜&š
œ˜Kšœœ
œ
˜Kšœœ˜/Kš
œ6˜6Kšœœ
œRŸ"˜Œ
Kš
œ9˜9Kšœœ
œR˜jK˜—Kšœ
˜—šœ œœ
œ˜?Kš
œ ™ Kš
œ=˜=Kšœœœ
˜)K˜—Kšœœ-œœ
œœ ˜‘
šœ œ$˜KK™†
—K˜K˜—šž	œœ
œ˜5Kšœœ
˜K˜ Kš
œO˜Ošœœ˜Kš
œX˜XKšœ
˜K˜—šœœ
œ
Ÿ˜4Kšœœ
œŸ(˜I—K™SKšœœ˜5K˜K˜—šžœœ
œ˜,Kšœ
œœ˜3Kšœœ˜Kšœœ˜Kšœ	œ
˜Kšœ@˜Gšœ
œ
˜
Kšœœ
œ
˜Kšœœ
˜Kšœœ'œ
œ
˜HKš
œ?˜?Kš
œ'˜'šœ
œ
˜Kšœ
œ( œŸ˜QKšœ Πct
˜9Kšœœ2˜CKšœŸ˜5—Kšœœ
œ˜)Kšœ˜K˜š
˜Kšœ&Ÿ˜=—Kšœ
˜—Kšœœ
˜K˜K˜—J™—™J˜šžœœ
œ
œ
˜"J˜J˜JšœœŸ˜(Jšœ	œ
˜Jšœœ
˜Jšœœœ˜$Jš
œ)˜)Jš
œ	œ
œ/œœ˜Ršœœ"œ˜IJ™7—JšœœI˜ZJ˜0J˜-J˜/J˜J˜J™(J™Ž
J˜—šžœœ
œ5
˜\JšœœœŸ
œ˜0Jšœœ
˜J˜šœ;œœ
˜PJšœ,œ
œ˜GJšœ
˜—šœœ˜š
œE˜EJšœ	œ˜—Jšœ
˜J˜—Jš
œH˜Hšœ˜Jšœœ
˜˜ JšœNœ˜SJšœ
˜J˜—Jšœœ
˜—Jšœœ"˜-Jš
œU˜UJ˜Jšœœ˜5šœ˜Jš
œH˜H—J˜J˜—šž
œœ
œ˜5J™XJ˜Jšœ2œ!˜YJšœœ+˜FJ˜J˜—šžœœ
œ˜8Jšœœ˜,J™β™2JšœOΟd
œ’
œ’
œ’
œΑ
’
œΙ
™€Jš	œ’
œ’
œ9’
œ’
œE™
Jšœ’
œ’
œC™f—J™…
Jšœœ
˜š
œ
˜
JšœTœ˜Z—šœœœ˜-JšœBœœŸ˜h—J˜—J™—™J˜š
ž
œœ
œœœ˜QJšœœ˜!Jšœœ
œ
œ
œ!Ÿœ˜IJš
œ˜J˜—šžœœ
œ%œ
œœ
œ
˜WJšœ	œ
œ
œ	œ
œ˜@Jšœœ˜Jš
œ˜Jšœœ
œ˜0šœ
œ˜Jš
œI˜I—Jš
œœœ
œ
œ
˜*Jšœœ
œ2œ˜KJšœœ
œ/˜DJš
œ˜J˜—šžœœ
œ˜3Jšœ	œ˜1Jšœœ
˜J˜&Jš
œU˜Ušœ˜Kšœœ
˜š
œ˜Kš
œL˜LJš
œ˜Jšœ
œ˜J˜—Kšœœ
˜—Kšœ
œ*˜4K˜—J˜šžœ
˜Jšœ
œ0˜BJšœNœ˜dJ˜J˜—šžœœœ œ˜PJšœ
œœ
œ
˜ Jš
œ<˜<J˜—J˜šžœœœœ˜2Jšœ
œœ
œ
˜Jš
œ(˜(J˜J˜——™<J™J˜(Jšœœ
˜"Jšœ%œ
˜)Jšœ%œ
˜)Jšœœœ
˜0Jšœœ(˜AJšœœ	Ÿ!˜<J˜šžœœœ"˜OJšœ˜ J˜'Jšœœ
˜J˜*Jšœœ
˜Jšœœ˜"Jšœ&Ÿ2˜XJšœ Ÿ˜<J˜Jšœœ
˜J˜Jšœ	œ˜Jšœœ
˜Jšœœ˜%Jšœ
œ
˜Jšœœ
˜
J˜Jšœœ˜5š
œ
˜
JšœWœ˜p—Jš	œ
œœ
œŸ˜VJšœœ8˜SJšœ ‘˜&šœœ
œ˜&šœ˜J™₯
šœœ˜&š
œ˜Jš
œ.˜.Jšœ
œ
œ
œ˜&Jšœœ#˜1J˜)Jšœœ
˜#Jšœ
˜J˜—Jšœ
˜—J™Išœœ'œ˜:J˜Jš
œ#˜#Jšœ
˜J˜—Jšœœ
˜—Jšœ
˜J˜—Jšœœ
œŸ#˜RJ™J™JJšœœœœ˜SJš
œ-˜-Jšœœœ
œœ(œ˜Ršœ
œ
Ÿ
˜"Jšœœ
œ˜Jšœœ˜JšœœŸ˜+JšœœŸ˜<—J™J™(Jš
œ+˜+Jšœ	œœ
œœ(œ˜Wšœ˜Jšœœ˜)˜
šœ˜˜Jš
œ˜Jš
œ0˜0Jšœ	œœ
œœ(œ˜WJšœœ%˜9J™]J˜—Jš
œ&˜&Jšœ
˜—J˜—JšœœŸ˜'Jšœœ˜—Jš
œ˜Jšœ
œ
œ
œ˜)Jšœœ
œQ˜fJš
œ˜J˜—š
žœœœœœ˜KJ™—
Jšœ
œ
˜Jšœœ
˜Jšœœ
œ
œ
˜Jš
œ4˜4Jšœœ
œ
œ
˜ Jš
œ%˜%Jšœœ ˜1Jš
œ
œ
œœ
œ
˜=Jšœ:œ&˜eJ˜&˜J˜——šžœœ˜šœœ˜'Jšœœ%˜=šœœ
œ*˜:Jš
œ5˜5——šœœ˜.Jšœœ%˜=šœœ
œ(˜8Jš
œ4˜4——šœœ˜.Jšœœ
˜Jš
œB˜BJšœœ
œ&˜6Jš
œ˜—š
œ˜Jšœ)œ˜L—Jšœœ
˜J˜J˜——™J˜˜EJ™XJ˜\J™ J˜!J˜J˜—šžœœ
œœ˜=Jš
œU˜UJš
œ9˜9Jšœœ
œ
Ÿ˜=š	œ
œ œ
œ˜Aš
œ
˜
J™Œ
Jš
œ˜šœœœœ
œ
œ
œ
˜GJš
œ#˜#Jšœœ
˜—Jšœœ
œ
œ
˜šœ%˜)Jšœ%œ*˜VJ™Š
Jšœ Ÿ˜/—J˜—šœ	œœ ˜GJš
œ™—š	œœœŸ‘
Ÿ‘
˜SJšœ
œ˜'Jš
œ(˜(Jš
œE˜EJšœ˜—Jšœ
˜—J˜EJ˜J˜—šžœœ
œ˜2Jšœœ˜4J˜—J˜J™JJ˜šœœ
œ
œ˜0Jš
Πfsk™kš
£j˜jJš
œ˜——šœœœŸ˜!J™8JšœBŸ™\JšœŸ ™'JšœŸ0™7JšœŸ™JšœŸH™MJ™J˜—š	œœ
œ
œ
œ˜NJ™’
J™——JšΟf
£`™aš£YΡcfs
˜cJš
œ1™1Jš
œk™k—Jš£[₯˜bJš£[₯	˜dš£Z₯˜eJš
œ[™[—š£Z₯
˜dJš
œ™—š£Ρbfs£,¦£
¦£¦£¦£₯
˜eJ™P—š£¦£M₯˜gJ™H—š£¦£<¦£₯˜eJ™O—š£¦£M₯
˜fJ™A—Jš£¦£M₯˜hJš£¦£=¦£¦£₯	˜cJš£¦£L₯˜pJ˜J˜™šœ!œ˜*J˜Jš
œ˜—Jš
œ\˜\—J˜™'K™<KšœΟr[™g—™'K™Kšœ§
™—™'K™Kšœ§ ™,—™2Kšœ§8™D—™2Kšœ§,™8—™2K™?Kšœ§
™—™(K™Kšœ§5™A—™4K™QKšœ§™'—™4Kšœ§:™F—™*K™,Kšœ§–
™’
—™*K™Ž
Kšœ§Ι
™Υ
—K™™&K™ΊKšœ§n™z—K™K™™)K™GKšœ§5™A—K™™*K™'Kšœ§K™W—™'K™(Kšœ§R™^Kšœ§™(—K™—…—] ¬k